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

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Bereichsbibliothek

Bereichszugriff begin cbegin   end cend rbegin crbegin   rend crend size ssize   data cdata reserve_hint (C++26)   empty

Range-Konvertierungen std::from_range_t std::from_range (C++23)(C++23)     to (C++23)

Behandlung von hängenden Iteratoren dangling borrowed_iterator_t borrowed_subrange_t

Range-Primitive
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)

Range-Konzepte
range borrowed_range    common_range	sized_range viewable_range    view	input_range output_range forward_range	bidirectional_range    random_access_range contiguous_range	approximately_sized_range (C++26) constant_range (C++23)

Ansichten
view_interface	subrange

Range-Fabriken
empty_viewviews::empty	single_viewviews::single	basic_istream_viewviews::istream	iota_viewviews::iota	repeat_viewviews::repeat (C++23)(C++23)

Range-Adaptoren
views::all_tviews::all as_rvalue_viewviews::as_rvalue (C++23)(C++23)   filter_viewviews::filter transform_viewviews::transform take_viewviews::take take_while_viewviews::take_while common_viewviews::common views::counted to_input_viewviews::to_input (C++26)(C++26)	ref_view drop_viewviews::drop drop_while_viewviews::drop_while lazy_split_viewviews::lazy_split split_viewviews::split join_viewviews::join join_with_viewviews::join_with (C++23)(C++23)   concat_viewviews::concat (C++26)(C++26) cache_latest_viewviews::cache_latest (C++26)(C++26)	owning_view 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)

Range generators std::generator (C++23)

Range-Adaptor-Closure-Objekte range_adaptor_closure (C++23)

Range-Adaptor-Objekte

Hilfselemente
copyable-box movable-box (bis C++23)  (C++23)	simple-view non-propagating-cache

 

std::ranges::drop_while_view

Memberfunktionen

drop_while_view::drop_while_view

drop_while_view::base

drop_while_view::pred

drop_while_view::begin

drop_while_view::end

Deduction Guides

 

Definiert in der Header-Datei <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     : public ranges::view_interface<drop_while_view<V, Pred>>	(1)	(seit C++20)
namespace views {     inline constexpr /* nicht spezifiziert */ drop_while = /* nicht spezifiziert */; }	(2)	(seit C++20)
Aufruf-Signatur
template< ranges::viewable_range R, class Pred >     requires /* siehe unten */ constexpr ranges::view auto drop_while( R&& r, Pred&& pred );		(seit C++20)
template< class Pred > constexpr /* Bereichsadapter-Closure */ drop_while( Pred&& pred );		(seit C++20)

1) Ein Bereichsadapter, der eine view von Elementen aus einer zugrundeliegenden Sequenz darstellt, beginnend mit dem ersten Element, für das der Prädikat false zurückgibt.

2) RangeAdaptorObject. Der Ausdruck views::drop_while(e, f) ist ausdrucksäquivalent zu drop_while_view(e, f) für beliebige geeignete Unterausdrücke e und f.

drop_while_view modelliert die Konzepte contiguous_range, random_access_range, bidirectional_range, forward_range, input_range und common_range, wenn die zugrundeliegende View V die entsprechenden Konzepte modelliert. Sie modelliert auch sized_range, wenn ranges::forward_range<V> und std::sized_sentinel_for<ranges::sentinel_t<V>, ranges::iterator_t<V>> modelliert werden.

Datenmember

Mitglied	Beschreibung
V base_ (privat)	die zugrunde liegende Ansicht ((exposition-only member object*)
copyable-box<Pred>(bis C++23)movable-box<Pred>(seit C++23) pred_ (privat)	das zugrunde liegende Funktions-Objekt ((exposition-only member object*)
non-propagating-cache<ranges::iterator_t<V>> cache_ (privat) (nur vorhanden, wenn V forward_range erfüllt)	ein Objekt, das das Ergebnis von begin() zwischenspeichert ((exposition-only member object*)

Member-Funktionen

(Konstruktor)	konstruiert eine drop_while_view (öffentliche Member-Funktion)
base	gibt eine Kopie der zugrunde liegenden (angepassten) View zurück (public member function)
pred	gibt eine Referenz auf die gespeicherte Prädikatfunktion zurück (public member function)
begin	gibt einen Iterator zum Anfang zurück (öffentliche Member-Funktion)
end	gibt einen Iterator oder Sentinel zum Ende zurück (öffentliche Member-Funktion)
Geerbt von std::ranges::view_interface
empty	gibt zurück, ob die abgeleitete Ansicht leer ist, bereitgestellt nur, wenn sie sized_range oder forward_range erfüllt (public member function of std::ranges::view_interface<D>)
cbegin (C++23)	gibt einen konstanten Iterator zum Anfang des Bereichs zurück (public member function of std::ranges::view_interface<D>)
cend (C++23)	gibt ein Sentinel für den konstanten Iterator des Bereichs zurück (public member function of std::ranges::view_interface<D>)
operator bool	gibt zurück, ob die abgeleitete Ansicht nicht leer ist, bereitgestellt nur, wenn ranges::empty darauf anwendbar ist (public member function of std::ranges::view_interface<D>)
data	gibt die Adresse der Daten der abgeleiteten Ansicht zurück, nur bereitgestellt, wenn ihr Iteratortyp contiguous_iterator erfüllt (öffentliche Memberfunktion von std::ranges::view_interface<D>)
size	gibt die Anzahl der Elemente in der abgeleiteten View zurück. Bereitgestellt, wenn sie forward_range erfüllt und ihr Sentinel- und Iteratortyp sized_sentinel_for erfüllen. (public member function of std::ranges::view_interface<D>)
front	gibt das erste Element in der abgeleiteten View zurück, bereitgestellt, wenn sie forward_range erfüllt (öffentliche Member-Funktion von std::ranges::view_interface<D>)
back	gibt das letzte Element in der abgeleiteten View zurück, nur bereitgestellt, wenn sie bidirectional_range und common_range erfüllt (öffentliche Member-Funktion von std::ranges::view_interface<D>)
operator[]	gibt das n-te Element in der abgeleiteten View zurück, nur bereitgestellt, wenn sie random_access_range erfüllt (öffentliche Member-Funktion von std::ranges::view_interface<D>)

Hilfsvorlagen

template< class T, class Pred > constexpr bool enable_borrowed_range<std::ranges::drop_while_view<T, Pred>> =     ranges::enable_borrowed_range<T>;		(seit C++20)

Diese Spezialisierung von std::ranges::enable_borrowed_range lässt drop_while_view borrowed_range erfüllen, wenn die zugrundeliegende View dies tut.

Anmerkungen

Um die für das range-Konzept erforderliche amortisierte konstante Zeitkomplexität zu bieten, wird das Ergebnis von begin im drop_while_view-Objekt zwischengespeichert. Wenn der zugrundeliegende Bereich nach dem ersten Aufruf von begin() modifiziert wird, können nachfolgende Verwendungen des drop_while_view-Objekts unerwartete Ergebnisse liefern.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <ranges>
#include <string>
#include <string_view>
 
using std::operator""sv;
 
[[nodiscard]]
constexpr bool is_space(char p) noexcept
{
    auto ne = [p](auto q) { return p != q; };
    return !!(" \t\n\v\r\f" | std::views::drop_while(ne));
};
 
[[nodiscard("trims the output")]]
constexpr std::string_view trim_left(std::string_view const in) noexcept
{
    auto view = in | std::views::drop_while(is_space);
    return {view.begin(), view.end()};
}
 
[[nodiscard("trims the output")]]
constexpr std::string trim(std::string_view const in)
{
    auto view = in
              | std::views::drop_while(is_space)
              | std::views::reverse
              | std::views::drop_while(is_space)
              | std::views::reverse
              ;
    return {view.begin(), view.end()};
}
 
int main()
{
    static_assert(trim_left(" \n C++23") == "C++23"sv);
 
    constexpr auto src{" \f\n\t\r\vHello, C++20!\f\n\t\r\v "sv};
    static_assert(trim(src) == "Hello, C++20!");
 
    static constexpr auto v = {0, 1, 2, 3, 4, 5};
    for (int n : v | std::views::drop_while([](int i) { return i < 3; }))
        std::cout << n << ' ';
    std::cout << '\n';
}

Ausgabe

3 4 5

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 3494	C++20	drop_while_view war nie ein borrowed_range	sie ist eine borrowed_range, wenn ihre zugrundeliegende View es ist

Siehe auch

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

ein view, der aus Elementen eines anderen view besteht, wobei die ersten N Elemente übersprungen werden (Klassen-Template) (Range-Adaptor-Objekt)