A C++ template library for embedded applications
MIT licensed
Designed and
maintained by
John Wellbelove
utility.h

Utility


A few useful utility functions and classes.
____________________________________________________________________________________________________
pair
template <typename T1, typename T2>
struct pair
A clone of std::pair

C++03
template <typename T1, typename T2>
pair<T1, T2> make_pair(T1 a, T2 b)

C++11 and above
template <typename T1, typename T2>
pair<T1, T2> make_pair(T1&& a, T2&& b)
Returns a pair.
____________________________________________________________________________________________________
Template deduction guides
C++17 and above

template <typename T1, typename T2>
pair(T1, T2) ->pair<T1, T2>;
____________________________________________________________________________________________________
exchange

template <typename T, typename U = T>
T exchange(T& object, const U& new_value)
Copies the new value to object and returns the old value.
Note: This is not an atomic operation.
__________________________________________________________________________________________________
add_const

template <typename T>
typename etl::add_const<T>::type& as_const(T& t)
Returns a value of type T as a const T.
__________________________________________________________________________________________________

coordinate_2d


template <typename T>
struct coordinate_2d

Member types

T x;
T y;
__________________________________________________________________________________________________

In_place disambiguation tags.


struct in_place_t

inline constexpr in_place_t in_place{}; // C++17
____________________________________________________________________________________________________
template <typename T> struct in_place_type_t

template <typename T>
inline constexpr in_place_type_t<T> in_place_type{}; // C++17
____________________________________________________________________________________________________
template <size_t I> struct in_place_index_t

template <size_t I>
inline constexpr in_place_index_t<I> in_place_index{}; // C++17
__________________________________________________________________________________________________

declval


template <typename T>
typename etl::add_rvalue_reference<T>::type declval() ETL_NOEXCEPT;
C++11
__________________________________________________________________________________________________
functor
For C++11 and above.
20.27.0

template <typename TReturn, typename... TParams>
class functor
Wraps a free/global function in a functor.
____________________________________________________________________________________________________
constexpr functor(TReturn(*ptr_)(TParams...))
Constructs a functor from a function pointer.
____________________________________________________________________________________________________
constexpr TReturn operator()(TParams... args) const
Function operator.
Calls the wrapped function with the forwarded parameters.
____________________________________________________________________________________________________

Example


void int Function(int i)
{
  return i;
}

// Note that the functor deduces the template parameters.
constexpr etl::functor f(Function);
__________________________________________________________________________________________________
member_function_wrapper
For C++11 and above.
20.27.0

template <typename TReturn, typename... TParams>
class member_function_wrapper<TReturn(TParams...)>
Wraps a member function in a static member function.
____________________________________________________________________________________________________
template <typename T, T& Instance, TReturn(T::* Method)(TParams...)>
static constexpr TReturn function(TParams... params)
The static function that calls the member function.
____________________________________________________________________________________________________

Example


class MyClass
{
public:

  int MemberFunction(int i)
  {
    return 2 * i;
  }
};

MyClass test;

constexpr int(*pf)(int)
        = &etl::member_function_wrapper<int(int)>::function<MyClass, test, &MyClass::MemberFunction>;

// Call
int result = pf(1);
__________________________________________________________________________________________________
functor_wrapper
For C++11 and above.
20.27.0

template <typename TReturn, typename... TParams>
class functor_wrapper<TReturn(TParams...)>
Wraps a functor in a static member function.
____________________________________________________________________________________________________
template <typename TFunctor, TFunctor& Instance>
static constexpr TReturn function(TParams... params)
The static function that calls the member function.
____________________________________________________________________________________________________

Example


class MyClass
{
public:

  int operator()(int i)
  {
    return 2 * i;
  }
};

MyClass test;

constexpr int(*pf)(int) = &etl::functor_wrapper<int(int)>::function<MyClass, test>;

// Call
int result = pf(1);
__________________________________________________________________________________________________
integer_sequence
20.14.0

template <typename T, T... Integers>
class integer_sequence
__________________________________________________________________________________________________
index_sequence
20.14.0

template <size_t... Indices>
using index_sequence = etl::integer_sequence<size_t, Indices...>;

template <size_t N>
make_index_sequence
__________________________________________________________________________________________________

select1st

select2nd


select1st is a functor object that takes a single argument, a pair, and returns the pair::first element.
select2nd is a functor object that takes a single argument, a pair, and returns the pair::second element.
____________________________________________________________________________________________________

size_of_type

20.36.0


template <typename T>
ETL_CONSTEXPR size_t size_of_type()
Returns the size of the type defined in T.
____________________________________________________________________________________________________
template <typename T>
ETL_CONSTEXPR size_t size_of_type(const T&)
Returns the size of the type defined in T.
____________________________________________________________________________________________________


ETL_SIZE_OF_OBJECT_TYPE(Object, Type)
Returns the size of Type defined in the declared type of Object.
C++11 and above
20.36.0

ETL_SIZE_OF_CLASS_TYPE(Class, Type)
Returns the size of Type defined in Class.
20.36.0