extract()

template<std::size_t I0, std::size_t I1, product_type Tuple>
requires ( (I0 <= size_v<Tuple>) && (I1 <= size_v<Tuple>) )

constexpr auto kumi::extract ( Tuple const &  t, index_t< I0 >  i0, index_t< I1 >  i1  )

constexprnoexcept

Extracts a sub-tuple from a product type.

Note

Does not participate in overload resolution if I0 and I1 do not verify that 0 <= I0 <= I1 <= size_v<T>.

Parameters

t	Tuple to extract from
i0	Compile-time index of the first element to extract.
i1	Compile-time index past the last element to extract. By default, i1 is equal to size_v<T>.

Returns

A new kumi::tuple containing to the selected elements of the input tuple.

Helper type

namespace kumi::result
{
  template<product_type Tuple, std::size_t I0, std::size_t I1=-1> struct extract;
 
  template<product_type Tuple, std::size_t I0, std::size_t I1=-1>
  using extract_t = typename extract<Tuple,I0,I1>::type;
}

Computes the type returned by a call to extract.

Example:

 
#include <kumi/tuple.hpp>
#include <iostream>
 
int main()
{
  using namespace kumi::literals;
 
  kumi::tuple a = { 1, 2.3, 4.5f,'6',"7", short{89} };
 
  auto head = extract(a,0_c,1_c);
  auto mid  = extract(a,1_c,3_c);
  auto last = extract(a,kumi::index<3>);
 
  std::cout << a << " => " << head << ' '  << mid << ' ' << last << '\n';
}