Namensräume
Varianten
Aktionen

std::array<T,N>::rbegin, std::array<T,N>::crbegin

Von cppreference.com
< cpp‎ | container‎ | array
 
 
 
 
reverse_iterator rbegin() noexcept;
(1) (seit C++11)
(constexpr seit C++17)
const_reverse_iterator rbegin() const noexcept;
(2) (seit C++11)
(constexpr seit C++17)
const_reverse_iterator crbegin() const noexcept;
(3) (seit C++11)
(constexpr seit C++17)

Gibt einen Reverse-Iterator auf das erste Element des umgekehrten array zurück. Er entspricht dem letzten Element des nicht umgekehrten array. Wenn das array leer ist, ist der zurückgegebene Iterator gleich rend().

range-rbegin-rend.svg

Inhalt

[bearbeiten] Rückgabewert

Reverse-Iterator auf das erste Element.

[bearbeiten] Komplexität

Konstant.

[bearbeiten] Hinweise

Der zugrunde liegende Iterator des zurückgegebenen Reverse-Iterators ist der End-Iterator. Daher wird der zurückgegebene Iterator ungültig, wenn und sobald der End-Iterator ungültig wird.

[bearbeiten] Beispiel

#include <algorithm>
#include <array>
#include <iostream>
#include <string>
#include <string_view>
 
void print(const std::string_view s) { std::cout << s << ' '; }
 
int main()
{
    const std::array<std::string_view, 8> data
    {
        "▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"
    };
    std::array<std::string, 8> arr;
 
    std::copy(data.cbegin(), data.cend(), arr.begin());
 
    print("Print 'arr' in direct order using [cbegin, cend):\t");
    std::for_each(arr.cbegin(), arr.cend(), print);
 
    print("\n\nPrint 'arr' in reverse order using [crbegin, crend):\t");
    std::for_each(arr.crbegin(), arr.crend(), print);
}

Ausgabe

Print 'arr' in direct order using [cbegin, cend):        ▁ ▂ ▃ ▄ ▅ ▆ ▇ █
 
Print 'arr' in reverse order using [crbegin, crend):     █ ▇ ▆ ▅ ▄ ▃ ▂ ▁

[bearbeiten] Siehe auch

gibt einen Reverse-Iterator zum Ende zurück
(public member function) [edit]
gibt einen Reverse-Iterator zum Anfang eines Containers oder Arrays zurück
(function template) [bearbeiten]