Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::begin: iterador inicial de un contenedor o array

std::begin unifica la obtención del primer iterador de un contenedor y del puntero al primer elemento de un array nativo.

Versión: C++23

Sintaxis

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

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

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

std::begin(range), de <iterator>, llama a range.begin() para un contenedor conservando constness y, para un array nativo T[N], devuelve un T* al primer elemento. No desreferencia el rango y funciona también si está vacío.

En código genérico, using std::begin; begin(x); introduce las funciones libres estándar en el conjunto de sobrecargas, mientras la llamada no cualificada permite a ADL añadir la de un tipo de usuario. Los arrays nativos como int[] no tienen miembro begin() y ADL por sí solo no encuentra para ellos la sobrecarga de std; por eso importa la declaración using.

Para un rango vacío el resultado es igual a std::end(range) y no debe desreferenciarse. Un iterador de un contenedor temporal puede quedar colgante tras la expresión completa; std::begin no protege la vida. Operaciones posteriores del contenedor también pueden invalidarlo.

Ejemplos

#include <array>
#include <iostream>
#include <iterator>

int main() {
    const std::array values{2, 5};
    std::cout << *std::begin(values) << '\n';
}

Resultado

2

std::begin → 2

Fuentes