std::rbegin, std::crbegin

template< class C >
auto rbegin( C& c ) noexcept(noexcept(c.rbegin()))
    -> decltype(c.rbegin());

template< class C >
auto rbegin( const C& c ) noexcept(noexcept(c.rbegin()))
    -> decltype(c.rbegin());

template< class T, std::size_t N >
std::reverse_iterator<T*> rbegin( T (&array)[N] ) noexcept;

template< class T >
std::reverse_iterator<const T*> rbegin( std::initializer_list<T> il ) noexcept;

template< class C >
auto crbegin( const C& c ) noexcept(noexcept(std::rbegin(c)))
    -> decltype(std::rbegin(c));

Renvoie un itérateur au début inversé de la plage donnée.

Paramètres

Valeur de retour

Exceptions

Peut lever des exceptions définies par l'implémentation.

Surcharges

Des surcharges personnalisées de rbegin peuvent être fournies pour les classes et les énumérations qui n'exposent pas de fonction membre rbegin() appropriée, mais qui peuvent être parcourues en itération.

Notes

La surcharge pour std::initializer_list est nécessaire car elle ne possède pas de fonction membre rbegin .

Exemple

#include <iostream>
#include <iterator>
#include <vector>
int main()
{
    std::vector<int> v = {3, 1, 4};
    auto vi = std::rbegin(v); // le type de "vi" est std::vector<int>::reverse_iterator
    std::cout << "*vi = " << *vi << '\n';
    *std::rbegin(v) = 42; // OK : après l'affectation v[2] == 42
//  *std::crbegin(v) = 13; // erreur : l'emplacement est en lecture seule
    int a[] = {-5, 10, 15};
    auto ai = std::rbegin(a); // le type de "ai" est std::reverse_iterator<int*>
    std::cout << "*ai = " << *ai << '\n';
    auto il = {3, 1, 4};
    // le type de "it" ci-dessous est std::reverse_iterator<int const*> :
    for (auto it = std::rbegin(il); it != std::rend(il); ++it)
        std::cout << *it << ' ';
    std::cout << '\n';
}

*vi = 4
*ai = 15
4 1 3

Rapports de défauts

Les rapports de défauts suivants modifiant le comportement ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi