std::begin, std::cbegin - cppreference.com

</tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody>

Devuelve un iterador al comienzo del rango dado.

1,2) Devuelve c.begin(), que normalmente es un iterador al comienzo de la secuencia representada por c.

1) Si C es un Container estándar, devuelve un objeto C::iterator.

2) Si C es un Container estándar, devuelve un objeto C::const_iterator.

3) Devuelve un puntero al comienzo de array.

4) Devuelve std::begin(c), con c siempre tratado como calificado const.

Si C es un Container estándar, devuelve un objeto C::const_iterator.

Parámetros

Valor de retorno

1,2) c.begin()

3) array

4) c.begin()

Excepciones

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;
    }
}

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.

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';
}

Véase también