CKTIS / C++
std::ranges::to — construir um contentor a partir de um intervalo
C++23 std::ranges::to constrói um objeto, normalmente um contentor, a partir de um intervalo de entrada. Permite terminar um pipeline de vistas com um resultado concreto, indicando o tipo completo do contentor ou um modelo cujos argumentos serão deduzidos.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
std::ranges::to<C>(range, args...)
range | std::ranges::to<C>(args...)
std::ranges::to<ContainerTemplate>(range, args...)
range | std::ranges::to<ContainerTemplate>(args...)std::ranges::to, disponível desde C++23 em <ranges>, constrói um resultado a partir de um intervalo que satisfaz input_range. Para um contentor como std::vector<int>, materializa os elementos em vez de criar outra vista preguiçosa. O tipo de destino C tem de ser um tipo de classe sem qualificadores cv e não pode satisfazer view.
A expressão std::ranges::to<std::vector<int>>(range) especifica explicitamente o tipo do resultado. A forma std::ranges::to<std::vector>(range) usa a dedução de argumentos de modelo de classe. Num pipeline, usa range | std::ranges::to<std::vector<int>>(): os () criam um objeto de fecho de pipeline. Os args... adicionais, como um alocador, são encaminhados para o construtor de contentor selecionado.
Para elementos diretamente convertíveis, a função tenta, por esta ordem: um construtor que aceite o intervalo, um construtor marcado com std::from_range, um construtor adequado que aceite um par de iteradores e, por fim, a construção com args... seguida da inserção dos elementos. Cada via tem os seus próprios requisitos. Os intervalos aninhados podem ser convertidos recursivamente; se nenhuma via permitida se aplicar, o programa é mal formado.
O exemplo cria um std::vector<int> com os quadrados de 1 a 5; o limite superior de std::views::iota(1, 6) é exclusivo. Materializar este pipeline percorre os seus elementos, por isso não uses um intervalo ilimitado sem limitar o número de elementos. É necessária uma implementação da biblioteca que suporte esta funcionalidade C++23: a opção de compilação do repositório, por si só, não comprova o suporte em produção. A referência fornecida é um projeto de norma em evolução, não uma edição C++23 definitiva.
Exemplos
#include <cstddef>
#include <iostream>
#include <ranges>
#include <vector>
int main() {
auto values = std::views::iota(1, 6)
| std::views::transform([](int n) { return n * n; })
| std::ranges::to<std::vector<int>>();
for (std::size_t i = 0; i < values.size(); ++i) {
if (i != 0) std::cout << ' ';
std::cout << values[i];
}
std::cout << '\n';
}
Resultado
1 4 9 16 25
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.