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

De cppreference.com

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

`iterator begin();`		(hasta C++11)
`iterator begin() noexcept;`		(desde C++11)
`const_iterator begin() const;`		(hasta C++11)
`const_iterator begin() const noexcept;`		(desde C++11)
`const_iterator cbegin() const noexcept;`		(desde C++11)

Devuelve un iterador al primer elemento del list.

Si el list está vacío, el iterador devuelto será igual a end().

Parámetros

(Ninguno)

Valor de retorno

Iterador al primer elemento.

Complejidad

Constante.

Ejemplo

#include <algorithm>
#include <iostream>
#include <numeric>
#include <string>
#include <list>

int main()
{
    std::list<int> nums {1, 2, 4, 8, 16};
    std::list<std::string> frutas {"naranja", "manzana", "frambuesa"};
    std::list<char> vacio; // contenedor vacío

    // Imprimir list.
    std::for_each(nums.begin(), nums.end(), [](const int n) { std::cout << n << ' '; });
    std::cout << '\n';

    // Suma todos los enteros en el contenedor list nums (si los hay), imprime solo el resultado.
    std::cout << "Suma de nums: "
              << std::accumulate(nums.begin(), nums.end(), 0) << '\n';

    // Imprime la primera fruta en el contenedor list frutas, comprueba si hay.
    if (!frutas.empty())
        std::cout << "Primera fruta: " << *frutas.begin() << '\n';

    if (vacio.begin() == vacio.end())
        std::cout << "list 'vacio' está vacío.\n";
}

Salida:

1 2 4 8 16
Suma de nums: 31
Primera fruta: naranja
list 'vacio' está vacío.

Véase también

Devuelve un iterador al final.
(función miembro pública) [editar]