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.