Compartilhar via


cbegin

Recupera um iterador const para o primeiro elemento em um contêiner especificado.

template<class Container>
    auto cbegin(const Container& cont) 
        -> decltype(cont.begin());

Parâmetros

  • cont
    Um contêiner ou initializer_list.

Valor de retorno

Uma constante cont.begin().

Comentários

Essa função funciona com todos os contêineres da STL e com initializer_list.

Você pode usar essa função membro no lugar da função de modelo begin(), de modo a garantir que o valor de retorno seja const_iterator. Normalmente, ela é usada juntamente com a palavra-chave de dedução de tipo auto, conforme mostrado no exemplo a seguir. No exemplo, considere que Container será um contêiner (não const) modificável ou initializer_list de qualquer tipo que oferece suporte a begin() e cbegin().

auto i1 = Container.begin();  // i1 is Container<T>::iterator
auto i2 = Container.cbegin(); // i2 is Container<T>::const_iterator

Requisitos

Cabeçalho: <iterator>

Namespace: std

Consulte também

Referência

<iterator>

begin

cend

end