CKTIS / C++
std::ranges::input_range — un rango legible
std::ranges::input_range describe un rango cuyo iterador permite leer elementos y avanzar a las posiciones siguientes. No garantiza varios recorridos: la lectura puede consumir los datos, como sucede con una vista de flujo.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#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> es un concepto de <ranges>. Su definición combina std::ranges::range<T> con std::input_iterator<std::ranges::iterator_t<T>>. El rango proporciona un iterador de inicio y un centinela de fin, y su iterador permite leer e incrementarse. Es una restricción de tipo que se comprueba en tiempo de compilación, no un contenedor ni una operación de lectura.
No des por hecho que se puede repetir el recorrido ni que las posiciones de iterador guardadas son independientes. Un rango de entrada puede ser de un solo paso; volver a llamar a begin no tiene por qué restablecer la posición inicial. std::ranges::forward_range, que es más fuerte, garantiza varios recorridos. std::ranges::input_range tampoco exige que el iterador y el centinela tengan tipos idénticos: ese requisito lo expresa std::ranges::common_range.
Que los elementos se puedan leer no implica que sean inmutables ni que se puedan modificar. El concepto tampoco exige un tamaño conocido ni almacenamiento contiguo. Úsalo para restringir una plantilla cuando un algoritmo necesite leer durante un único recorrido; otras operaciones sobre los elementos pueden requerir restricciones adicionales.
El ejemplo usa std::views::istream<int> sobre un flujo en memoria. Las aserciones muestran un rango de entrada que no es un rango forward. El bucle lee los números del flujo y los suma al total acumulado. La instrucción que sigue al bucle imprime el total una sola vez: 60 seguido de un salto de línea. No hagas un recorrido preliminar solo para contar los elementos antes de procesarlos.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.