array::cbegin

Artigo
02/24/2013

Retorna um iterador de acesso aleatório const para o primeiro elemento no recipiente.

const_iterator cbegin() const;

Valor de retorno

Um iterador de acesso aleatório const que trata o primeiro elemento em array Class (TR1) ou para o local que é bem-sucedido arrayvazia.Você deve sempre comparar o valor retornado com array::cend ou array::end para assegurá-lo é válido.

Comentários

Com o valor de retorno de array::cbegin, o objeto de array não pode ser alterado.

Exemplo

// array_cbegin.cpp
// compile with: /EHsc
#include <array>
#include <iostream>

int main()
{
    using namespace std;
    array<int, 2> c1 = {1, 2};
    array<int, 2>::const_iterator c1_Iter;

    cout << "The array c1 contains elements:";
    c1_Iter = c1.cbegin();
    for (; c1_Iter != c1.cend(); c1_Iter++)
    {
        cout << " " << *c1_Iter;
    }
    cout << endl;

    // The following line would be an error because iterator is const
    // *c1.cbegin() = 200;
}