Namespaces
Variants

std::ranges:: elements_of

From cppreference.net
C++
Ranges library
Range adaptors
Определено в заголовочном файле <ranges>
template < ranges:: range R, class Allocator = std:: allocator < std:: byte > >
struct elements_of ;
(начиная с C++23)

Инкапсулирует range . Специализации elements_of действуют как тег в наборах перегрузок для разграничения случаев, когда диапазон должен обрабатываться как последовательность, а не как одиночное значение.

Содержание

Параметры шаблона

R - тип, удовлетворяющий требованиям range
Allocator - тип аллокатора, соответствующий требованиям Allocator

Члены данных

Название члена Определение
range
диапазон типа R
(публичный объект-член)
allocator
аллокатор типа Allocator . Имеет инициализатор по умолчанию, который инициализирует себя значением
(публичный объект-член)

Все эти члены объявлены с атрибутом [[ no_unique_address ]] .

Руководство по выводу

template < class R, class Allocator = std:: allocator < std:: byte > >
elements_of ( R && , Allocator = Allocator ( ) ) - > elements_of < R && , Allocator > ;
(начиная с C++23)

Пример

Запустить этот код 
#include <any>
#include <generator>
#include <iostream>
#include <ranges>
#include <string_view>
template<bool Elementwise>
std::generator<std::any> gen(std::ranges::input_range auto&& r)
{
    if constexpr (Elementwise)
        co_yield std::ranges::elements_of(r); // возвращает каждый элемент r
    else
        co_yield r;                           // возвращает r как единое значение
}
int main()
{
    auto test = std::string_view{"test"};
    for (std::any a : gen<true>(test))
        std::cout << '[' << std::any_cast<char>(a) << "] ";
    std::cout << '\n';
    for (std::any a : gen<false>(test))
        std::cout << '[' << std::any_cast<std::string_view>(a) << "] ";
    std::cout << '\n';
}

Вывод: 

[t] [e] [s] [t] 
[test]

Ссылки

  • Стандарт C++23 (ISO/IEC 14882:2024):
  • 26.5.6 Шаблон класса elements_of [range.elementsof]