std::rbegin, std::crbegin

 

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

 

Iterator-Bibliothek

Iterator-Konzepte
indirectly_readable (C++20) indirectly_writable (C++20) weakly_incrementable (C++20) incrementable (C++20) is-integer-like is-signed-integer-like (C++20)(C++20)	sentinel_for (C++20) sized_sentinel_for (C++20) input_iterator (C++20) output_iterator (C++20) input_or_output_iterator (C++20)	forward_iterator (C++20) bidirectional_iterator (C++20) random_access_iterator (C++20) contiguous_iterator (C++20)
Iterator-Primitive
input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tagcontiguous_iterator_tag (C++20)	iter_value_titer_difference_titer_reference_titer_const_reference_titer_rvalue_reference_titer_common_reference_t (C++20)(C++20)(C++20)(C++23)(C++20)(C++20)	iterator (veraltet in C++17) iterator_traits incrementable_traits (C++20) indirectly_readable_traits (C++20)
Algorithmus-Konzepte und Hilfsprogramme
Indirekte aufrufbare Konzepte
indirectly_unary_invocableindirectly_regular_unary_invocable (C++20)(C++20)	indirect_unary_predicate (C++20) indirect_binary_predicate (C++20)	indirect_equivalence_relation (C++20) indirect_strict_weak_order (C++20)
Gemeinsame Algorithmus-Anforderungen
indirectly_movable (C++20) indirectly_movable_storable (C++20) indirectly_copyable (C++20)	indirectly_copyable_storable (C++20)   indirectly_swappable (C++20) indirectly_comparable (C++20)	permutable (C++20) mergeable (C++20) sortable (C++20)
Dienstprogramme
indirect_result_t (C++20)	projected (C++20)	projected_value_t (C++26)
Iterator-Adapter
reverse_iterator make_reverse_iterator (C++14) move_iterator (C++11) make_move_iterator (C++11) default_sentinel_tdefault_sentinel (C++20)(C++20) unreachable_sentinel_tunreachable_sentinel (C++20)(C++20)	front_insert_iterator back_insert_iterator inserter insert_iterator front_inserter back_inserter move_sentinel (C++20)	common_iterator (C++20) counted_iterator (C++20) basic_const_iterator (C++23) const_iterator (C++23) const_sentinel (C++23) make_const_iterator (C++23) make_const_sentinel (C++23)
Stream-Iteratoren istream_iterator    ostream_iterator istreambuf_iterator ostreambuf_iterator	Iterator-Anpassungspunkte ranges::iter_move (C++20) ranges::iter_swap (C++20)
Iterator-Operationen advance distance prev (C++11)   next (C++11) ranges::advance (C++20) ranges::distance (C++20) ranges::prev (C++20) ranges::next (C++20)	Bereichszugriff begincbegin (C++11)(C++14) rbegincrbegin (C++14)(C++14)   endcend (C++11)(C++14) rendcrend (C++14)(C++14)   sizessize (C++17)(C++20) empty (C++17) data (C++17)

 

Definiert in der Header-Datei <array>
Definiert in Header <deque>
Definiert in Header <flat_map>
Definiert in Header <flat_set>
Definiert in Header <forward_list>
Definiert in Header <inplace_vector>
Definiert in Header <iterator>
Definiert in Header <list>
Definiert in Header <map>
Definiert in Header <regex>
Definiert in Header <set>
Definiert in Header <span>
Definiert in Header <string>
Definiert in Header <string_view>
Definiert in Header <unordered_map>
Definiert in Header <unordered_set>
Definiert in Header <vector>
template< class C > auto rbegin( C& c ) -> decltype(c.rbegin());	(1)	(seit C++14) (constexpr seit C++17)
template< class C > auto rbegin( const C& c ) -> decltype(c.rbegin());	(2)	(seit C++14) (constexpr seit C++17)
template< class T, std::size_t N > std::reverse_iterator<T*> rbegin( T (&array)[N] );	(3)	(seit C++14) (constexpr seit C++17)
template< class T > std::reverse_iterator<const T*> rbegin( std::initializer_list<T> il );	(4)	(seit C++14) (constexpr seit C++17)
template< class C > auto crbegin( const C& c ) -> decltype(std::rbegin(c));	(5)	(seit C++14) (constexpr seit C++17)

Gibt einen Iterator zum Rückwärtsanfang des gegebenen Bereichs zurück.

1,2) Gibt c.rbegin() zurück, was typischerweise ein Iterator zum Rückwärtsanfang der von c dargestellten Sequenz ist.

1) Wenn C ein Standard-Container ist, wird ein C::reverse_iterator-Objekt zurückgegeben.

2) Wenn C ein Standard-Container ist, wird ein C::const_reverse_iterator-Objekt zurückgegeben.

3) Gibt ein std::reverse_iterator<T*>-Objekt zum Rückwärtsanfang von array zurück.

4) Gibt ein std::reverse_iterator<const T*>-Objekt zum Rückwärtsanfang von il zurück.

5) Gibt std::rbegin(c) zurück, wobei c immer als const-qualifiziert behandelt wird.

Wenn C ein Standard-Container ist, wird ein C::const_reverse_iterator-Objekt zurückgegeben.

Parameter

c	-	Ein Container oder eine Ansicht mit einer Memberfunktion rbegin
array	-	Ein Array beliebigen Typs
il	-	Eine std::initializer_list

Rückgabewert

1,2) c.rbegin()

3) std::reverse_iterator<T*>(array + N)

4) std::reverse_iterator<const T*>(il.end())

5) c.rbegin()

Exceptions

Kann implementierungsdefinierte Ausnahmen auslösen.

Überladungen

Benutzerdefinierte Überladungen von rbegin können für Klassen und Enumerationen bereitgestellt werden, die keine geeignete Memberfunktion rbegin() bereitstellen, aber iterierbar sind.

Überladungen von rbegin, die durch argumentabhängige Suche gefunden werden, können verwendet werden, um das Verhalten von std::ranges::rbegin und std::ranges::crbegin anzupassen.

(seit C++20)

Hinweise

Die Überladung für std::initializer_list ist notwendig, da sie keine Memberfunktion rbegin besitzt.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <iterator>
#include <vector>
 
int main()
{
    std::vector<int> v = {3, 1, 4};
    auto vi = std::rbegin(v); // the type of “vi” is std::vector<int>::reverse_iterator
    std::cout << "*vi = " << *vi << '\n';
 
    *std::rbegin(v) = 42; // OK: after assignment v[2] == 42
//  *std::crbegin(v) = 13; // error: the location is read-only
 
    int a[] = {-5, 10, 15};
    auto ai = std::rbegin(a); // the type of “ai” is std::reverse_iterator<int*>
    std::cout << "*ai = " << *ai << '\n';
 
    auto il = {3, 1, 4};
    // the type of “it” below is std::reverse_iterator<int const*>:
    for (auto it = std::rbegin(il); it != std::rend(il); ++it)
        std::cout << *it << ' ';
    std::cout << '\n';
}

Ausgabe

*vi = 4
*ai = 15
4 1 3

Siehe auch

begincbegin (C++11)(C++14)	gibt einen Iterator zum Anfang eines Containers oder Arrays zurück (Funktionsvorlage)
endcend (C++11)(C++14)	gibt einen Iterator zum Ende eines Containers oder Arrays zurück (Funktionsvorlage)
rendcrend (C++14)	gibt einen Reverse-End-Iterator für einen Container oder ein Array zurück (function template)
ranges::rbegin (C++20)	gibt einen Reverse-Iterator zu einem Range zurück (Customization Point Objekt)
ranges::crbegin (C++20)	gibt einen Reverse-Iterator zu einem schreibgeschützten Range zurück (Customization Point Objekt)