std::ranges::ref_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

 

Definiert in der Header-Datei <ranges>
template< ranges::range R >     erfordert std::is_object_v<R> class ref_view     : public ranges::view_interface<ref_view<R>>		(seit C++20)

ref_view ist eine view der Elemente eines anderen range. Sie umschließt eine Referenz auf dieses range.

Datenelemente

Member-Name	Definition
r_ (private)	Ein Zeiger vom Typ R* auf das zugrundeliegende Range. ((exposition-only member object*)

Member-Funktionen

(Konstruktor)	konstruiert eine ref_view, die auf das gegebene Range verweist (öffentliche Memberfunktion)
base	gibt die Referenz auf das referenzierte Range zurück (öffentliche Memberfunktion)
begin	gibt den Anfangsiterator des referenzierten Ranges zurück (öffentliche Memberfunktion)
end	gibt den Sentinel des referenzierten Ranges zurück (öffentliche Memberfunktion)
empty	prüft, ob das referenzierte Range leer ist (öffentliche Memberfunktion)
size	gibt die Größe des referenzierten sized_range zurück (öffentliche Memberfunktion)
data	gibt den Zeiger auf den Anfang des referenzierten contiguous_range zurück (öffentliche Memberfunktion)
Geerbt von std::ranges::view_interface
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>)
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>)

std::ranges::ref_view::ref_view

template< /*different-from*/<ref_view> T >     erfordert std::convertible_to<T, R&> && erfordert { _FUN(std::declval<T>()); } constexpr ref_view( T&& t );		(seit C++20)

Initialisiert r_ mit std::addressof(static_cast<R&>(std::forward<T>(t))).

/*different-from*/<T, U> ist erfüllt, wenn und nur wenn std::remove_cvref_t<T> und std::remove_cvref_t<U> nicht denselben Typ haben und Überladungen von _FUN als void _FUN(R&); void _FUN(R&&) = delete; deklariert sind.

Parameter

t

-

Range zur Referenz

std::ranges::ref_view::base

constexpr R& base() const;		(seit C++20)

Äquivalent zu return *r_;.

std::ranges::ref_view::begin

constexpr ranges::iterator_t<R> begin() const;		(seit C++20)

Äquivalent zu return ranges::begin(*r_);.

std::ranges::ref_view::end

constexpr ranges::sentinel_t<R> end() const;		(seit C++20)

Äquivalent zu return ranges::end(*r_);.

std::ranges::ref_view::empty

constexpr bool empty() const     erfordert requires { ranges::empty(*r_); };		(seit C++20)

Äquivalent zu return ranges::empty(*r_);.

std::ranges::ref_view::size

constexpr auto size() const     erfordert ranges::sized_range<R>;		(seit C++20)

Äquivalent zu return ranges::size(*r_);.

std::ranges::ref_view::data

constexpr auto data() const     erfordert ranges::contiguous_range<R>;		(seit C++20)

Äquivalent zu return ranges::data(*r_);.

Deduktionshilfen

template< class R > ref_view( R& ) -> ref_view<R>;		(seit C++20)

Hilfsschablonen

template< class T > constexpr bool enable_borrowed_range<ranges::ref_view<T>> = true;		(seit C++20)

Diese Spezialisierung von std::ranges::enable_borrowed_range lässt ref_view borrowed_range erfüllen.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <ranges>
 
int main()
{
    const std::string s{"cosmos"};
 
    const std::ranges::take_view tv{s, 3};
    const std::ranges::ref_view rv{tv};
 
    std::cout
        << std::boolalpha
        << "call empty() : " << rv.empty() << '\n'
        << "call size()  : " << rv.size() << '\n'
        << "call begin() : " << *rv.begin() << '\n'
        << "call end()   : " << *(rv.end() - 1) << '\n'
        << "call data()  : " << rv.data() << '\n'
        << "call base()  : " << rv.base().size() << '\n' // ~> tv.size()
        << "range-for    : ";
 
    for (const auto c : rv)
        std::cout << c;
    std::cout << '\n';
}

Ausgabe

call empty() : false
call size()  : 3
call begin() : c
call end()   : s
call data()  : cosmos
call base()  : 3
range-for    : cos

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
P2325R3	C++20	Standardkonstruktor wurde als view bereitgestellt muss default_initializable sein	entfernt zusammen mit der Anforderung

Siehe auch

reference_wrapper (C++11)	CopyConstructible und CopyAssignable Referenz-Wrapper (Klassen-Template)
ranges::owning_view (C++20)	ein view mit exklusivem Besitz eines range (Klassen-Template)
views::all_tviews::all (C++20)	ein view, der alle Elemente eines range enthält (Alias-Template) (Range-Adaptor-Objekt)