Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::views::take — una vista de los primeros elementos de un rango

std::views::take, declarado en <ranges>, crea una vista de como máximo count elementos iniciales de un rango. Conserva su orden, no crea un contenedor independiente y permite tanto la llamada directa como la notación de tubería.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <ranges>
std::views::take(range, count)
range | std::views::take(count)

std::views::take es un objeto adaptador de rangos proporcionado por <ranges>. La expresión std::views::take(range, count) equivale a range | std::views::take(count). Si count no es negativo y se puede representar en el tipo de diferencia de los iteradores del rango, el resultado expone los primeros count elementos en su orden original, o el rango entero si contiene menos elementos. Si count es 0, el resultado está vacío.

Es una vista, no un contenedor copiado: aplicar el adaptador no copia los elementos en una colección nueva ni elimina los elementos finales de la fuente. Los elementos se leen durante la iteración. El resultado no tiene por qué ser del tipo std::ranges::take_view; para ciertos tipos de rangos, el estándar especifica otras representaciones equivalentes de vista, por lo que normalmente conviene usar auto.

El argumento count debe poder convertirse al tipo de diferencia de los iteradores del rango. Use un valor no negativo que se pueda representar en ese tipo, incluso cuando el adaptador no construya una std::ranges::take_view. Por ejemplo, en el caso optimizado de std::span, el adaptador convierte count a ese tipo antes de tomar el mínimo entre el valor convertido y la longitud del rango. Un valor de tipo sin signo demasiado grande para representarse puede convertirse en -1 y dar lugar a operaciones aritméticas no válidas con iteradores en lugar de seleccionar el rango entero. Cuando el adaptador construye una std::ranges::take_view, el constructor exige que el valor convertido no sea negativo. Un valor negativo no significa contar desde el final. Si el tipo del rango de entrada es una especialización de std::ranges::empty_view, el adaptador evalúa el argumento count y descarta su valor sin construir una std::ranges::take_view, por lo que un valor negativo no infringe esa precondición.

Al adaptar un contenedor existente mediante un lvalue, la vista hace referencia a ese contenedor. Por tanto, la fuente debe seguir existiendo mientras se use la vista, y las operaciones que invalidan iteradores también pueden invalidar el acceso a través de ella. En el ejemplo, el cambio de values[0] después de crear first se refleja en la salida: 11 20 30. El código mostrado se ejecutó sin cambios en un entorno aislado. Su salida estándar coincidió exactamente con la salida indicada.

Ejemplos

#include <array>
#include <iostream>
#include <ranges>

int main() {
    std::array<int, 5> values{10, 20, 30, 40, 50};
    auto first = values | std::views::take(3);
    values[0] = 11;

    bool separator = false;
    for (int value : first) {
        if (separator) std::cout << ' ';
        std::cout << value;
        separator = true;
    }
    std::cout << '\n';
}

Resultado

11 20 30

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.

Fuentes