std::ranges::take_view<V>::end

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de rangos

Acceso a rangos begin cbegin   end cend rbegin crbegin   rend crend size ssize   data cdata empty

Conversiones de rangos std::from_range_t std::from_range (C++23)(C++23)     to (C++23)

Manejo de iteradores pendientes dangling borrowed_iterator_t borrowed_subrange_t

Primitivas de rangos
range_size_trange_difference_trange_value_t elements_of (C++23)	iterator_tconst_iterator_tsentinel_tconst_sentinel_t (C++23)(C++23)	range_reference_trange_const_reference_trange_rvalue_reference_trange_common_reference_t (C++23)

Conceptos de rangos
range borrowed_range    sized_range	common_range view viewable_range	input_range output_range forward_range	bidirectional_range    random_access_range contiguous_range	constant_range (C++23)

Vistas
view_interface	subrange

Fábricas de rangos
empty_viewviews::empty	single_viewviews::single	basic_istream_viewviews::istream	iota_viewviews::iota	repeat_viewviews::repeat (C++23)(C++23)

Adaptadores de rangos
views::all_tviews::all ref_view owning_view as_rvalue_viewviews::as_rvalue (C++23)(C++23)   filter_viewviews::filter transform_viewviews::transform take_viewviews::take take_while_viewviews::take_while concat_viewviews::concat (C++26)(C++26) views::counted	drop_viewviews::drop drop_while_viewviews::drop_while join_viewviews::join join_with_viewviews::join_with (C++23)(C++23)   lazy_split_viewviews::lazy_split split_viewviews::split common_viewviews::common cache_latest_viewviews::cache_latest (C++26)(C++26)	reverse_viewviews::reverse as_const_viewviews::as_const (C++23)(C++23) elements_viewviews::elements keys_viewviews::keys values_viewviews::values enumerate_viewviews::enumerate (C++23)(C++23) zip_viewviews::zip (C++23)(C++23) zip_transform_viewviews::zip_transform (C++23)(C++23)	adjacent_viewviews::adjacent (C++23)(C++23) views::pairwise (C++23) adjacent_transform_viewviews::adjacent_transform (C++23)(C++23) views::pairwise_transform (C++23) chunk_viewviews::chunk (C++23)(C++23) slide_viewviews::slide (C++23)(C++23) chunk_by_viewviews::chunk_by (C++23)(C++23) stride_viewviews::stride (C++23)(C++23) cartesian_product_viewviews::cartesian_product (C++23)(C++23)

Generadores de rangos std::generator (C++23)

Objetos cierre adaptadores de rangos range_adaptor_closure (C++23)

Objetos adaptadores de rangos

Elementos auxiliares
copyable-box movable-box (hasta C++23)  (C++23)	simple-view non-propagating-cache

 

std::ranges::take_view

Funciones miembro

take_view::take_view (C++20)

take_view::base (C++20)

take_view::begin (C++20)

take_view::end (C++20)

take_view::size (C++20)

Guías de deducción

Centinela

take_view::sentinel::sentinel (C++20)

take_view::sentinel::base (C++20)

operator==(std::counted_iterator,take_view::sentinel) (C++20)

 

constexpr auto end() requires (!__SimpleView<V>);	(1)	(desde C++20)
constexpr auto end() const requires ranges::range<const V>;	(2)	(desde C++20)

Devuelve un centinela o un iterador que representa el final de la vista take_view. El final de la vista take_view es o bien uno después del count-ésimo elemento en el rango subyacente, o el final del rango subyacente si este último tiene menos de count elementos.

1) Devuelve un take_view::/*sentinel*/<false>, un std::default_sentinel_t, o un ranges::range_iterator_t<V>.

2) Devuelve un take_view::/*sentinel*/<true>, un std::default_sentinel_t, o un ranges::range_iterator_t<const V>.

La sobrecarga (1) no participa en la resolución de sobrecarga si V es una vista simple (es decir, si V y const V son vistas con el mismo tipo iterador y tipo centinela).

Parámetros

(Ninguno)

Valor de retorno

El resultado depende de los conceptos satisfechos por el tipo (posiblemente calificado const) de la vista subyacente Base_, que es V (para la sobrecarga (1)) o const V (para la sobrecarga (2)).

Sea base_ la vista subyacente.

La vista subyacente satisface ...	random_access_range
Sí	No
sized_range	Sí	ranges::begin(base_) + ranges::range_difference_t<Base_>(this->size())	std::default_sentinel
No	1) /*sentinel*/<false>{ranges::end(base_)} 2) /*sentinel*/<true>{ranges::end(base_)}

Ejemplo

Ejecuta este código

#include <list>
#include <ranges>
#include <iterator>
#include <iostream>
#include <type_traits>

int main() {
    const auto list1 = { 3, 1, 4, 1, 5 };
    const auto seq1 = list1 | std::views::take(4);
    static_assert(std::ranges::sized_range<decltype(seq1)> and
                  std::ranges::random_access_range<decltype(seq1)> and
                  std::is_same_v<decltype(seq1.end()), decltype(list1.end())>);
    for (auto it = seq1.begin(); it != seq1.end(); std::cout << *it++ << ' '){ }
    std::cout << '\n';

    std::list list2 = { 2, 7, 1, 8, 2 };
    const auto seq2 = list2 | std::views::take(4);
    static_assert(std::ranges::sized_range<decltype(seq2)> and
                  not std::ranges::random_access_range<decltype(seq2)> and
                  std::is_same_v<decltype(seq2.end()), std::default_sentinel_t>);
    for (auto it = seq2.begin(); it != std::default_sentinel; std::cout << *it++ << ' '){ }
    std::cout << '\n';
}

Salida:

3 1 4 1
2 7 1 8

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
P2393R1	C++20	Las conversiones implícitas entre tipos enteros con signo y sin signo podrían fracasar.	Se hicieron explícitas.

Véase también

begin (C++20)	Devuelve un iterador al comienzo. (función miembro pública)
counted_iterator (C++20)	Adaptador de iterador que rastrea la distancia hasta el final del rango. (plantilla de clase)
operator== (C++20)	Compara un centinela con un iterador devuelto desde take_view::begin. (función)