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

CKTIS / C++

std::ranges::input_range — um intervalo legível

std::ranges::input_range descreve um intervalo cujo iterador permite ler elementos e avançar para as posições seguintes. Não garante vários percursos: a leitura pode consumir os dados, como acontece com uma vista de fluxo.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <ranges>

template<class T>
concept input_range = std::ranges::range<T> &&
                      std::input_iterator<std::ranges::iterator_t<T>>;

// Usage:
template<std::ranges::input_range R>
void consume(R&& r);

std::ranges::input_range<T> é um conceito de <ranges>. A sua definição combina std::ranges::range<T> com std::input_iterator<std::ranges::iterator_t<T>>. O intervalo fornece um iterador inicial e uma sentinela final, e o iterador permite ler e incrementar. Trata-se de uma restrição de tipo verificada em tempo de compilação, não de um contentor nem de uma operação de leitura.

Não pressuponhas que o percurso pode ser repetido ou que as posições de iterador guardadas são independentes. Um intervalo de entrada pode permitir apenas uma passagem; voltar a chamar begin não tem necessariamente de repor a posição inicial. O conceito mais forte std::ranges::forward_range garante vários percursos. std::ranges::input_range também não exige que o iterador e a sentinela tenham tipos idênticos — esse requisito é expresso por std::ranges::common_range.

A possibilidade de ler não implica que os elementos sejam imutáveis nem que seja permitido alterá-los. O conceito também não exige um tamanho conhecido nem armazenamento contíguo. Usa-o para restringir um modelo quando um algoritmo precisa de ler durante um único percurso; outras operações sobre os elementos podem exigir restrições próprias.

O exemplo usa std::views::istream<int> sobre um fluxo em memória. As asserções mostram um intervalo de entrada que não é um intervalo forward. O ciclo lê os números do fluxo e soma-os à medida que os lê. A instrução a seguir ao ciclo apresenta o total uma única vez: 60 seguido de uma mudança de linha. Não faças um percurso preliminar apenas para contar os elementos antes de os processares.

Exemplos

#include <iostream>
#include <locale>
#include <ranges>
#include <sstream>

int main() {
    std::istringstream stream{"10 20 30"};
    stream.imbue(std::locale::classic());
    auto numbers = std::views::istream<int>(stream);

    static_assert(std::ranges::input_range<decltype(numbers)>);
    static_assert(!std::ranges::forward_range<decltype(numbers)>);

    int total = 0;
    for (int value : numbers) {
        total += value;
    }
    std::cout << total << '\n';
}

Resultado

60

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