std::ranges::views::drop_while, std::ranges::drop_while_view

 

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::drop_while_view

Funciones miembro

drop_while_view::drop_while_view (C++20)

drop_while_view::base (C++20)

drop_while_view::pred (C++20)

drop_while_view::begin (C++20)

drop_while_view::end (C++20)

Guías de deducción

 

Definido en el archivo de encabezado <ranges>
template<ranges::view V, class Pred >     requires ranges::input_range<V>&&              std::is_object_v<Pred>&&              std::indirect_unary_predicate<const Pred, ranges::iterator_t<V>> class drop_while_view :publicranges::view_interface<drop_while_view<V, Pred>>	(1)	(desde C++20)
namespace views {     inlineconstexpr/*no especificado*/ drop_while =/*no especificado*/; }	(2)	(desde C++20)
Signatura de la llamada
template<ranges::viewable_range R, class Pred >     requires /* véase a continuación */ constexprranges::viewauto drop_while( R&& r, Pred&& pred );		(desde C++20)
template<class Pred > constexpr/*cierre de adaptador de rango*/ drop_while( Pred&& pred );		(desde C++20)

1) Un adaptador de rango que representa una vista (view) de elementos de una secuencia subyacente, comenzando en el primer elemento para el que el predicado devuelve false.

2)Objetos adaptadores de rango. La expresión views::drop_while(e, f) es equivalente en expresión a drop_while_view(e, f) para cualquier subexpresión e y f adecuadas.

drop_while_view modela los conceptos contiguous_range, random_access_range, bidirectional_range, forward_range, input_range, y common_range cuando la vista subyacente V modela los conceptos respectivos. También modela sized_range si ranges::forward_range<V> y std::sized_sentinel_for<ranges::sentinel_t<V>, ranges::iterator_t<V>> se modelan.

Equivalente en expresión

La expresión e es equivalente-en-expresión a la expresión f, si e y f tienen los mismos efectos, ambas potencialmente lanzan o ambas potencialmente no lanzan (es decir, noexcept(e)==noexcept(f)), y ambas son subexpresiones constantes o ambas no son subexpresiones constantes.

Funciones miembro

(constructor) (C++20)	Construye un objeto drop_while_view (función miembro pública)
base (C++20)	Devuelve una copia de la vista (adaptada) subyacente. (función miembro pública)
pred (C++20)	Devuelve una referencia al predicado almacenado. (función miembro pública)
begin (C++20)	Devuelve un iterador al comienzo. (función miembro pública)
end (C++20)	Devuelve un iterador o un centinela al final. (función miembro pública)
Heredadas de std::ranges::view_interface
empty (C++20)	Devuelve si la vista derivada está vacía o no. Se proporciona si la vista derivada satisface forward_range. (función miembro pública de std::ranges::view_interface<D>)
operator bool (C++20)	Devuelve si la vista derivada está vacía o no. Se proporciona si ranges::empty le es aplicable. (función miembro pública de std::ranges::view_interface<D>)
data (C++20)	Obtiene la dirección de los datos de una vista derivada. Se proporciona si su tipo iterador satisface contiguous_iterator. (función miembro pública de std::ranges::view_interface<D>)
size (C++20)	Devuelve el número de elementos en la vista derivada. Se proporciona si la vista derivada satisface forward_range y su centinela y tipo iterador satisfacen sized_sentinel_for. (función miembro pública de std::ranges::view_interface<D>)
front (C++20)	Devuelve el primer elemento en la vista derivada. Se proporciona si la vista derivada satisface forward_range. (función miembro pública de std::ranges::view_interface<D>)
back (C++20)	Devuelve el último elemento en una vista derivada. Se proporciona si la vista derivada satisface bidirectional_range y common_range. (función miembro pública de std::ranges::view_interface<D>)
operator[] (C++20)	Devuelve el enésimo elemento en la vista derivada. Se proporciona si la vista derivada satisface random_access_range. (función miembro pública de std::ranges::view_interface<D>)

Plantillas auxiliares

template<class T, class Pred> inlineconstexprbool enable_borrowed_range<std::ranges::drop_while_view<T, Pred>>=     std::ranges::enable_borrowed_range<T>;		(desde C++20)

Esta especialización de std::ranges::enable_borrowed_range hace que drop_while_view satisfaga borrowed_range cuando la vista subyacente lo hace.

Notas

Para proporcionar la complejidad de tiempo constante amortizada requerida por el concepto range, el resultado de begin se almacena en caché dentro del objeto drop_while_view. Si el rango subyacente se modifica después de la primera llamada a begin(), los usos posteriores del objeto drop_while_view pueden tener un comportamiento no intuitivo.

Ejemplo

Ejecuta este código

#include <cctype>#include <iomanip>#include <iostream>#include <ranges>#include <string>#include <string_view>   std::string trim(std::string_viewconst in){auto view = in | std::views::drop_while(isspace)| std::views::reverse| std::views::drop_while(isspace)| std::views::reverse;return{view.begin(), view.end()};}   int main(){constauto s = trim(" \f\n\t\r\vHola, C++20!\f\n\t\r\v ");std::cout<<std::quoted(s)<<'\n';   staticconstexprauto v ={0, 1, 2, 3, 4, 5};for(int n : v | std::views::drop_while([](int i){return i <3;})){std::cout<< n <<' ';}}

Salida:

"Hola, C++20!" 3 4 5

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
LWG 3494	C++20	drop_while_view nunca era un borrowed_range.	Es un borrowed_range si su vista subyacente lo es.

Véase también

ranges::drop_viewviews::drop (C++20)

Una vista (view) que consiste en los elementos de otra vista, saltándose los primeros N elementos. (plantilla de clase)(objeto adaptador de rango)