Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::begin: iterador inicial de um contentor ou array

std::begin uniformiza a obtenção do primeiro iterador de um contentor e do ponteiro para o primeiro elemento de um array nativo.

Versão: C++23

Sintaxe

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>, chama range.begin() para um contentor preservando constness e, para um array nativo T[N], devolve um T* para o primeiro elemento. Não desreferencia o intervalo e funciona quando está vazio.

Em código genérico, using std::begin; begin(x); introduz as funções livres padrão no conjunto de sobrecargas, enquanto a chamada não qualificada permite a ADL acrescentar a de um tipo de utilizador. Arrays nativos como int[] não têm membro begin() e ADL sozinho não encontra para eles a sobrecarga em std; por isso a declaração using é importante.

Num intervalo vazio, o resultado é igual a std::end(range) e não pode ser desreferenciado. Um iterador de um contentor temporário pode ficar pendente após a expressão completa; std::begin não protege o tempo de vida. Operações posteriores do contentor também o podem invalidar.

Exemplos

#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

Fontes