std::rbegin, std::crbegin
De cppreference.com
Definido en el archivo de encabezado <array>
|
||
Definido en el archivo de encabezado <deque>
|
||
Definido en el archivo de encabezado <flat_map>
|
||
Definido en el archivo de encabezado <flat_set>
|
||
Definido en el archivo de encabezado <forward_list>
|
||
Definido en el archivo de encabezado <inplace_vector>
|
||
Definido en el archivo de encabezado <iterator>
|
||
Definido en el archivo de encabezado <list>
|
||
Definido en el archivo de encabezado <map>
|
||
Definido en el archivo de encabezado <regex>
|
||
Definido en el archivo de encabezado <set>
|
||
Definido en el archivo de encabezado <span>
|
||
Definido en el archivo de encabezado <string>
|
||
Definido en el archivo de encabezado <string_view>
|
||
Definido en el archivo de encabezado <unordered_map>
|
||
Definido en el archivo de encabezado <unordered_set>
|
||
Definido en el archivo de encabezado <vector>
|
||
(1) | ||
template< class C > auto rbegin( C& c ) -> decltype(c.rbegin()); |
(desde C++14) (hasta C++17) |
|
template< class C > constexpr auto rbegin( C& c ) -> decltype(c.rbegin()); |
(desde C++17) | |
(2) | ||
template< class C > auto rbegin( const C& c ) -> decltype(c.rbegin()); |
(desde C++14) (hasta C++17) |
|
template< class C > constexpr auto rbegin( const C& c ) -> decltype(c.rbegin()); |
(desde C++17) | |
(3) | ||
template< class T, std::size_t N > std::reverse_iterator<T*> rbegin( T (&array)[N] ); |
(desde C++14) (hasta C++17) |
|
template< class T, std::size_t N > constexpr std::reverse_iterator<T*> rbegin( T (&array)[N] ); |
(desde C++17) | |
(4) | ||
template< class T > std::reverse_iterator<const T*> rbegin( std::initializer_list<T> il ); |
(desde C++14) (hasta C++17) |
|
template< class T > constexpr std::reverse_iterator<const T*> |
(desde C++17) | |
(5) | ||
template< class C > auto crbegin( const C& c ) -> decltype(std::rbegin(c)); |
(desde C++14) (hasta C++17) |
|
template< class C > constexpr auto crbegin( const C& c ) -> decltype(std::rbegin(c)); |
(desde C++17) | |
Devuelve un iterador al comienzo inverso del rango dado.
1,2) Devuelve c.rbegin(), que es típicamente un iterador al comienzo inverso de la secuencia representada por c.
5) Devuelve std::rbegin(c), con c siempre tratado como calificado const.
Contenido |
[editar] Parámetros
c | - | Un contenedor con una función miembro rbegin .
|
array | - | Un array de tipo arbitrario. |
il | - | Una lista de inicializadores std::initializer_list. |
[editar] Valor de retorno
1,2) c.rbegin()
3) std::reverse_iterator<T*>(array + N)
4) std::reverse_iterator<const T*>(il.end())
5) c.rbegin()
[editar] Excepciones
Puede lanzar excepciones definidas por la implementación.
[editar] Sobrecargas
Pueden proporcionarse sobrecargas personalizadas de rbegin
para clases que no exponen una función miembro rbegin()
adecuada, y que sin embargo pueden iterarse.
Las sobrecargas de |
(desde C++20) |
[editar] Notas
La sobrecarga para std::initializer_list es necesaria porque no tiene una función miembro rbegin
.
[editar] Ejemplo
Ejecuta este código
#include <iostream> #include <iterator> #include <vector> int main() { std::vector<int> v = {3, 1, 4}; auto vi = std::rbegin(v); // el tipo de “vi” es std::vector<int>::reverse_iterator std::cout << "*vi = " << *vi << '\n'; *std::rbegin(v) = 42; // de acuerdo: después de la asignación v[2] == 42 // *std::crbegin(v) = 13; // ERROR: la ubicación es de solo lectura int a[] = {-5, 10, 15}; auto ai = std::rbegin(a); // el tipo de “ai” es std::reverse_iterator<int*> std::cout << "*ai = " << *ai << '\n'; auto il = {3, 1, 4}; // el tipo de “it” debajo es std::reverse_iterator<int const*>: for (auto it = std::rbegin(il); it != std::rend(il); ++it) std::cout << *it << ' '; std::cout << '\n'; }
Salida:
*vi = 4 *ai = 15 4 1 3
[editar] Véase también
(C++11)(C++14) |
Devuelve un iterator al comienzo de un contenedor o array. (plantilla de función) |
(C++11)(C++14) |
Devuelve un iterator al final de un contenedor o array (plantilla de función) |
(C++14) |
Devuelve un iterador inverso al final para un contenedor o array (plantilla de función) |
(C++20) |
Devuelve un iterador inverso a un rango (objeto punto de personalización) |
(C++20) |
Devuelve un iterador inverso a un rango de solo lectura (objeto punto de personalización) |