Skip to content

TsukiNi22/ai-utils / skills/libutils/libutils

libutils

Verified

Reference of Tsukini's C++20 library libutils (namespace utils::, github TsukiNi22/libutils) - every section, header, class and public method with the version and commit hash it was generated from, how to link/include it, exceptions/error codes, verbose, and how to find what changed since. Use whenever code uses or could use libutils (utils::..., include "utils/...", find_package(utils)), when the user asks which libutils class/function does something, how to use one, or what is new in libutils, instead of searching the library sources.

FileKindSize
SKILL.mdskill md14.6 KB
reference/VERSION.mdmarkdown612 B
reference/api/algorithms.mdmarkdown10.0 KB
reference/api/arguments.mdmarkdown8.4 KB
reference/api/attribute.mdmarkdown9.0 KB
reference/api/cli.mdmarkdown5.0 KB
reference/api/concepts.mdmarkdown3.0 KB
reference/api/encapsulation.mdmarkdown9.8 KB
reference/api/exception.mdmarkdown6.7 KB
reference/api/manip.mdmarkdown10.9 KB
reference/api/math.mdmarkdown2.3 KB
reference/api/network.mdmarkdown8.4 KB
reference/api/platform.mdmarkdown6.0 KB
reference/api/pool.mdmarkdown5.1 KB
reference/api/root.mdmarkdown2.2 KB
reference/api/security.mdmarkdown8.8 KB
reference/api/system.mdmarkdown10.7 KB
reference/api/type.mdmarkdown38.5 KB
reference/api/verbose.mdmarkdown3.6 KB
reference/exception-codes.mdmarkdown7.6 KB
reference/index.mdmarkdown20.0 KB
scripts/check.shexecutablescript2.7 KB
scripts/gen_api.pyexecutablescript20.8 KB
scripts/update.shexecutablescript2.3 KB

reference/api/attribute.md

View on GitHub
# libutils `attribute`

Generated from libutils `v4.3.1` (commit `7913070`, 2026-10-22) by `scripts/gen_api.py`, do not edit by hand.

## `utils/attribute/Attribute.hpp`

Include the right file from the c++ version used or selected

Namespace: `std`

```cpp
#define _legacy [[deprecated("Only kept for backward compatibility; no removal in sight ._.")]]
#define _migration(major, minor, fix) [[deprecated("Retained for backward compatibility; will be removed in a future version (estimated: ~v" #major "." #minor "." #fix ")")]]
#define _legacy
#define _migration(major, minor, fix)

// namespace std
constexpr std::size_t hardware_destructive_interference_size = 64; // xstyle: ignore CPP-NAMESPACE-INDENT (fallback in the include region)
constexpr std::size_t hardware_constructive_interference_size = 64; // xstyle: ignore CPP-NAMESPACE-INDENT
```

## `utils/attribute/c++14.hpp`

Different attribute used for optimisation & other thing Version for c++14 and above

```cpp
#define _nodiscard __attribute__((warn_unused_result)) // Warn for unused return
#define _noinline __attribute__((noinline)) // Cancel any auto inline from the compiler
#define _noreturn [[noreturn]] // Signal a function that never return
#define _unused __attribute__((unused)) // Signal an unused variable
#define _hidden // No ELF visibility on Windows (dllexport/dllimport model)
#define _hidden __attribute__((visibility("hidden"))) // Change the visibility on a shared lib
#define _ctor __attribute__((constructor)) // Execute before the main
#define _dtor __attribute__((destructor)) // Execute after the main
#define _fallthrough __attribute__((fallthrough)) // Ingore warn for no break in switch
#define _deprecated(info) [[deprecated(info)]] // Signal a deprecated function
#define _deprecated(info) // Not defined with this flag
#define _likely // Not defined in this version
#define _unlikely // Not defined in this version
#define _likely_c(c) __builtin_expect(!!(c), 1) // Signal a condition that has a bigger probability of appening
#define _unlikely_c(c) __builtin_expect(!!(c), 0) // Signal a condition that has a smallest probability of appening
#define _expect(c, v) __builtin_expect(c, v) // Signal a condition that has a high probability of having the given value
#define _assume(expr) __builtin_assume(expr) // Assume a given expr as true
#define _cold __attribute__((cold)) // Signal a function that has a small number of use
#define _hot __attribute__((hot)) // Signal a function that has a huge number of use
#define _noaddress // Not defined in this version
#define _packed __attribute__((packed)) // Remove the memory padding in a struct
#define _alignas(n) alignas(n) // Set the memory padding in a struct
#define _alloc_size(i_size) __attribute__((alloc_size(i_size))) // Signal a malloc of the given size in the argument
#define _alloc_size_mul(i_mul, i_size) __attribute__((alloc_size(i_mul, i_size))) // Signal a malloc of the given size in the argument multiply by another argument
#define _write_only(i_ptr, i_size) __attribute__((access(write_only, i_ptr, i_size))) // Set the mode of a ptr in the argument so that it can only be writed in the limit of the size
#define _read_only(i_ptr, i_size) __attribute__((access(read_only, i_ptr, i_size))) // Set the mode of a ptr in the argument so that it can only be readed in the limit of the size
#define _nonnull(i_ptr) __attribute__((nonnull(i_ptr))) // Warn on given null value on the given argument

```

## `utils/attribute/c++17.hpp`

Different attribute used for optimisation & other thing Version for c++17 and above

```cpp
#define _nodiscard [[nodiscard]] // Warn for unused return
#define _noinline [[noinline]] // Cancel any auto inline from the compiler
#define _noreturn [[noreturn]] // Signal a function that never return
#define _unused [[maybe_unused]] // Signal an unused variable
#define _hidden // No ELF visibility on Windows (dllexport/dllimport model)
#define _hidden [[gnu::visibility("hidden")]] // Change the visibility on a shared lib
#define _ctor [[gnu::constructor]] // Execute before the main
#define _dtor [[gnu::destructor]] // Execute after the main
#define _fallthrough [[fallthrough]] // Ingore warn for no break in switch
#define _deprecated(info) [[deprecated(info)]] // Signal a deprecated function
#define _deprecated(info) // Not defined with this flag
#define _likely // Not defined in this version
#define _unlikely // Not defined in this version
#define _likely_c(c) __builtin_expect(!!(c), 1) // Signal a condition that has a bigger probability of appening
#define _unlikely_c(c) __builtin_expect(!!(c), 0) // Signal a condition that has a smallest probability of appening
#define _expect(c, v) __builtin_expect(c, v) // Signal a condition that has a high probability of having the given value
#define _assume(expr) __builtin_assume(expr) // Assume a given expr as true
#define _cold [[gnu::cold]] // Signal a function that has a small number of use
#define _hot [[gnu::hot]] // Signal a function that has a huge number of use
#define _noaddress // Not defined in this version
#define _packed [[gnu::packed]] // Remove the memory padding in a struct
#define _alignas(n) alignas(n) // Set the memory padding in a struct
#define _alloc_size(i_size) [[gnu::alloc_size(i_size)]] // Signal a malloc of the given size in the argument
#define _alloc_size_mul(i_mul, i_size) [[gnu::alloc_size(i_mul, i_size)]] // Signal a malloc of the given size in the argument multiply by another argument
#define _write_only(i_ptr, i_size) [[gnu::access(write_only, i_ptr, i_size)]] // Set the mode of a ptr in the argument so that it can only be writed in the limit of the size
#define _read_only(i_ptr, i_size) [[gnu::access(read_only, i_ptr, i_size)]] // Set the mode of a ptr in the argument so that it can only be readed in the limit of the size
#define _nonnull(i_ptr) [[gnu::nonnull(i_ptr)]] // Warn on given null value on the given argument

```

## `utils/attribute/c++20.hpp`

Different attribute used for optimisation & other thing Version for c++20 and above

```cpp
#define _nodiscard [[nodiscard]] // Warn for unused return
#define _noinline [[noinline]] // Cancel any auto inline from the compiler
#define _noreturn [[noreturn]] // Signal a function that never return
#define _unused [[maybe_unused]] // Signal an unused variable
#define _hidden // No ELF visibility on Windows (dllexport/dllimport model)
#define _hidden [[gnu::visibility("hidden")]] // Change the visibility on a shared lib
#define _ctor [[gnu::constructor]] // Execute before the main
#define _dtor [[gnu::destructor]] // Execute after the main
#define _fallthrough [[fallthrough]] // Ingore warn for no break in switch
#define _deprecated(info) [[deprecated(info)]] // Signal a deprecated function
#define _deprecated(info) // Not defined with this flag
#define _likely [[likely]] // Signal a condition that has a bigger probability of appening
#define _unlikely [[unlikely]] // Signal a condition that has a smallest probability of appening
#define _likely_c(c) __builtin_expect(!!(c), 1) // Signal a condition that has a bigger probability of appening
#define _unlikely_c(c) __builtin_expect(!!(c), 0) // Signal a condition that has a smallest probability of appening
#define _expect(c, v) __builtin_expect(c, v) // Signal a condition that has a high probability of having the given value
#define _assume(expr) [[assume(expr)]] // Assume a given expr as true
#define _cold [[gnu::cold]] // Signal a function that has a small number of use
#define _hot [[gnu::hot]] // Signal a function that has a huge number of use
#define _noaddress [[no_unique_address]] // Remove unique address for elements
#define _packed [[gnu::packed]] // Remove the memory padding in a struct
#define _alignas(n) alignas(n) // Set the memory padding
#define _alloc_size(i_size) [[gnu::alloc_size(i_size)]] // Signal a malloc of the given size in the argument
#define _alloc_size_mul(i_mul, i_size) [[gnu::alloc_size(i_mul, i_size)]] // Signal a malloc of the given size in the argument multiply by another argument
#define _write_only(i_ptr, i_size) [[gnu::access(write_only, i_ptr, i_size)]] // Set the mode of a ptr in the argument so that it can only be writed in the limit of the size
#define _read_only(i_ptr, i_size) [[gnu::access(read_only, i_ptr, i_size)]] // Set the mode of a ptr in the argument so that it can only be readed in the limit of the size
#define _nonnull(i_ptr) [[gnu::nonnull(i_ptr)]] // Warn on given null value on the given argument

```

## `utils/attribute/fallback.hpp`

Different attribute used for optimisation & other thing Fallback if the version used is inferior to c++14

```cpp
#define _nodiscard
#define _noinline
#define _noreturn
#define _unused
#define _hidden
#define _ctor
#define _dtor
#define _deprecated(info)
#define _fallthrough
#define _likely
#define _unlikely
#define _likely_c(c) (c)
#define _unlikely_c(c) (c)
#define _expect(c, v) (c)
#define _assume(expr)
#define _cold
#define _hot
#define _noaddress
#define _packed
#define _alignas(n)
#define _alloc_size(i_size)
#define _alloc_size_mul(i_mul, i_size)
#define _write_only(i_ptr, i_size)
#define _read_only(i_ptr, i_size)
#define _nonnull(i_ptr)

```
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall