vector::front

Retorna uma referência para o primeiro elemento em um objeto vector.

reference front( );  const_reference front( ) const;

Valor de retorno

Uma referência para o primeiro elemento no objeto vector. Se o vetor está vazio, o retorno será indefinido.

Comentários

Se o valor de retorno de front for atribuído a const_reference, o objeto de vetor não poderá ser modificado. Se o valor de retorno front é atribuído a um referência, o objeto de vetor pode ser modificado.

Ao compilar com secure_scl 1, um erro de tempo de execução ocorrerá se você tentar acessar um elemento em um vetor vazio. Consulte Iteradores Verificados para obter mais informações.

Exemplo

// vector_front.cpp
// compile with: /EHsc
#include <vector>
#include <iostream>
using namespace std;  
int main( )
{
  vector <int> vec;
    vec.push_back(10);
    vec.push_back(20);

    int& i = vec.front();
    const int& ci = vec.front();

    cout << "The value of vec[0] is " << i << endl;

    // front() returns a reference, not an iterator
    // by incrementing i, we change the value of the first element
    i++;
    cout << "Now, the value of vec[0] is " << i << endl;

   // ci++; compiler error because ci is const}

Saída

The first integer of v1 is 10
Now, the first integer of v1 is 11

Requisitos

Cabeçalho: <vector>

Namespace: std

Consulte também

Referência

Classe vector

vector::front e vector::back

Biblioteca de Modelos Padrão