.. | ||
include/mp | ||
tests | ||
.travis.yml | ||
LICENSE-0BSD | ||
README.md |
mp
A small, 0BSD-licensed metaprogramming library for C++17.
This is intended to be a lightweight and easy to understand implementation of a subset of useful metaprogramming utilities.
Usage
Just add the include
directory to your include path. That's it.
typelist
A mp::list
is a list of types. This set of headers provide metafunctions for manipulating lists of types.
Constructor
mp::list
: Constructs a list.mp::lift_sequence
: Lifts a value sequence into a list. Intended for use onstd::integral_sequence
.
Element access
mp::get
: Gets a numbered element of a list.mp::head
: Gets the first element of a list.mp::tail
: Gets all-but-the-first-element as a list.
Properties
mp::length
: Gets the length of a list.mp::contains
: Determines if this list contains a specified element.
Modifiers
mp::append
: Constructs a list with the provided elements appended to it.mp::prepend
: Constructs a list with the provided elements prepended to it.
Operations
mp::concat
: Concantenates multiple lists together.mp::cartesian_product
: Construct a list containing the cartesian product of the provided lists.
Conversions
mp::lower_to_tuple
: This operation only works on a list solely containing metavalues. Results in astd::tuple
with equivalent values.
metavalue
A metavalue is a type of template std::integral_constant
.
Constants
- mp::true_type: Aliases to
std::true_type
- mp::false_type: Aliases to
mp::false_type
Constructor
- mp::value: Aliases to
std::integral_constant
- mp::bool_value: Aliases to
std::bool_constant
- mp::size_value: Constructs a metavalue with value of type std::size_t
mp::lift_value
: Lifts a value of any arbitrary type to become a metavalue
Conversions
mp::value_cast
Operations
mp::value_equal
: Compares value equality, ignores type. Usestd::is_same
for strict comparison.mp::logic_if
: Like std::conditional but has a bool metavalue as first argument.mp::bit_not
: Bitwise notmp::bit_and
: Bitwise andmp::bit_or
: Bitwise ormp::bit_xor
: Bitwise xormp::logic_not
: Logical notmp::logic_and
: Logical conjunction (no short circuiting, always results in a mp:bool_value)mp::logic_or
: Logical disjunction (no short circuiting, always results in a mp:bool_value)mp::conjunction
: Logical conjunction (with short circuiting, preserves type)mp::disjunction
: Logical disjunction (with short circuiting, preserves type)mp::sum
: Sum of valuesmp::product
: Product of values
metafunction
std::void_t
: Always returnsvoid
.mp::identity
: Identity metafunction. Can be used to establish a non-deduced context. See also C++20std::type_identity
.mp::apply
: Invoke a provided metafunction with arguments specified in a list.mp::map
: Apply a provided metafunction to each element of a list.mp::bind
: Curry a metafunction. A macroMM_MP_BIND
is provided to make this a little prettier.
traits
Type traits not in the standard library.
function_info
mp::parameter_count_v
: Number of parameters a function hasmp::parameter_list
: Get a typelist of the parameter typesmp::get_parameter
: Get the type of a parameter by indexmp::equivalent_function_type
: Get an equivalent function type (for MFPs this does not include the class)mp::equivalent_function_type_with_class
: Get an equivalent function type with explicitthis
argument (MFPs only)mp::return_type
: Return type of the functionmp::class_type
: Only valid for member function pointer types. Gets the class the member function is associated with.
integer_of_size
mp::signed_integer_of_size
: Gets a signed integer of the specified bit-size (if it exists)mp::unsigned_integer_of_size
: Gets an unsigned integer of the specified bit-size (if it exists)
Misc
mp::is_instance_of_template
: Checks if a type is an instance of a template class.
License
Please see LICENSE-0BSD.