Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes