extract()

template<std::size_t I0, std::size_t I1, concepts::product_type Tuple>

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

inlinenodiscardconstexprnoexcept

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.

Examples:

#include <kumi/kumi.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';
}

#include <kumi/kumi.hpp>
#include <iostream>
 
int main()
{
  using namespace kumi::literals;
 
  kumi::record a =  { "a"_id = 1, "b"_id = 2.3, "c"_id = 4.5f, "d"_id = '6'
                    , "e"_id = "7", "f"_id = 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';
}