std::begin, std::cbegin

Devuelve un iterador al comienzo del rango dado.

[editar] Parámetros

[editar] Valor de retorno

[editar] Excepciones

[editar] Sobrecargas

Se pueden proporcionar sobrecargas personalizadas de begin para clases y enumeraciones que no exponen una función miembro begin() adecuada, pero que se pueden iterar. La biblioteca estándar ya proporciona las siguientes sobrecargas:

De manera similar al uso de swap (descrito en Swappable), el uso típico de la función begin en un contexto genérico es un equivalente de using std::begin; begin(arg);, que permite que tanto las sobrecargas seleccionadas por la búsqueda dependiente de argumentos 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;
    }
}

[editar] Notas

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

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

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

[editar] 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

[editar] Véase también