std::begin, std::cbegin

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

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

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

template< class C > 
constexpr auto cbegin( const C& c ) noexcept(/* see below */)
    -> decltype(std::begin(c));

Devuelve un iterador al inicio del rango dado.

Parámetros

Valor de retorno

Excepciones

Sobrecargas

Sobrecargas personalizadas de begin pueden proporcionarse para clases y enumeraciones que no exponen una función miembro begin() adecuada, pero que pueden ser iteradas. Las siguientes sobrecargas ya están proporcionadas por la biblioteca estándar:

Similar al uso de swap (descrito en Swappable ), el uso típico de la función begin en contexto genérico es equivalente a using std :: begin ; begin ( arg ) ; , lo que permite que tanto las sobrecargas seleccionadas por ADL para tipos definidos por el usuario como las plantillas de función de la biblioteca estándar aparezcan en el mismo conjunto de sobrecargas.

template<typename Container, typename Function>
void for_each(Container&& cont, Function f)
{
    using std::begin;
    auto it = begin(cont);
    using std::end;
    auto end_it = end(cont);
    while (it != end_it)
    {
        f(*it);
        ++it;
    }
}

Notas

Las sobrecargas que no son de arreglo reflejan exactamente el comportamiento de C::begin . Sus efectos pueden ser sorprendentes si la función miembro no tiene una implementación razonable.

std::cbegin se introduce para unificar los accesos a rangos de miembros y no miembros. Véase también LWG issue 2128 .

Si C es una vista de constante superficial, std::cbegin puede devolver un iterador mutable. Este comportamiento es inesperado para algunos usuarios. Véase también P2276 y P2278 .

Ejemplo

#include <iostream>
#include <iterator>
#include <vector>
int main() 
{
    std::vector<int> v = {3, 1, 4};
    auto vi = std::begin(v);
    std::cout << std::showpos << *vi << '\n'; 
    int a[] = {-5, 10, 15};
    auto ai = std::begin(a);
    std::cout << *ai << '\n';
}

+3
-5

Véase también