Cxxomfort independent utilities

cxxomfort ships with a few independent utilities not dependent on features of specific C++ Standards. These are accessed by directly including the header:

#include <cxxomfort/cxxo-utils.hpp>
// alternatively included from general cxxomfort tools
#include <cxxomfort/backports.hpp>

The header is not intended to be directly included, but can be done so nonetheless. Still, including most of the backport header files guarantees its inclusion.

All features here are directly under the cxxomfort namespace (unless they are eg.: macros).

Interfaces

The following is an incomplete listing of features available under this namespace:

Generalistic Tools

• rvoid - regular void based on early p0146
• None - generalised "None" type and keyword
• noop_fn , noop() noop generalised function
• cxxomfort::bool_once() - checks and unsets a bool variable in one step
• cxxomfort::outp - output parameter wrapper
• cxxomfort::prio<N> - priority tag

Code Generation

• Base implementation for tiny[u]int.
• CXXO_GENERATE_RELATIONALS , CXXO_GENERATE_RELATIONALS2 - generate non.member relational operators given existing operator== and/or operator< .
• cxxo-foreach iterate over elements.
• "I12N (initialization)" Initialization of Sequences.

Utilities

• constexpr_tag - a tag type similar to std::nothrow , to select constexpr function overloads
• cxxomfort::functiontype - template with information about function types.
• cxxomfort::function_caller - wrap a C function as their own type.
• coalesce() - coalesces a sequence of pointer-like objects.
• coalesce_ptrs() - return the first element in a collection of possibly-NULL pointers.
• cxxomfort::array_ref - views over sequences of data.
• cxxomfort::basic_cstring_view and derived like cstring_view - views over native C strings.
• cxxomfort::st_math - compile-time operations on integers, pre-C++11.

Page

Class array< T, N >

Implementation of std::array

Class array_ref< T, IdxType >

array_ref - a non-owning view to sequences of contiguous data

File cxxo-utils.hpp

Header File

Member cxxomfort::bool_once (bool &flag) CXXO_NOEXCEPTNOTHROW

Manages a bool flag so that it evaluates to true once.

Member cxxomfort::max (constexpr_t, T a, T b) CXXO_NOEXCEPTNOTHROW

constexpr version of std::max()

Member cxxomfort::min (constexpr_t, T a, T b) CXXO_NOEXCEPTNOTHROW

constexpr version of std::min()

Member cxxomfort::None_t

"None" type

Class prio< I >

Priority tag for ordering specializations

Class static_abs< T, u >

Compile-time absolute value of an integral, pre-C++11.

Class static_clamp< T, t, m, M >

Compile-time clamp a valur between two values, pre-C++11.

Class static_intlog< N, Ba >

Compile-time integer logarithm on the Naturals, pre-C++11.

Class static_intpow< Int, x, y >

Compile-time integer exponentiation, pre-C++11.

Class static_sign< T, u >

Compile-time sign of an integer