Namespaces
Variants

std::vector<T,Allocator>:: front

From cppreference.net

C++
Containers library
std::vector
Member types
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
reference front ( ) ;
(1) (constexpr desde C++20)
const_reference front ( ) const ;
(2) (constexpr desde C++20)

Devuelve una referencia al primer elemento del contenedor.

Si empty() es true , el comportamiento es indefinido.

(hasta C++26)

Si empty() es true :

  • Si la implementación está hardened , ocurre una contract violation . Además, si el manejador de violación de contrato retorna bajo semántica de evaluación "observe", el comportamiento es indefinido.
  • Si la implementación no está hardened, el comportamiento es indefinido.
(desde C++26)

Contenidos

Valor de retorno

Referencia al primer elemento.

Complejidad

Constante.

Notas

Para un contenedor c , la expresión c. front ( ) es equivalente a * c. begin ( ) .

Ejemplo

El siguiente código utiliza front para mostrar el primer elemento de un std:: vector < char > :

Ejecutar este código 
#include <cassert>
#include <vector>
int main()
{
    std::vector<char> letters{'a', 'b', 'c', 'd'};
    assert(letters.front() == 'a');
}

Véase también

acceder al último elemento
(función miembro pública)
(C++11)
devuelve un iterador inverso al final
(función miembro pública)
(C++11)
devuelve un iterador al principio
(función miembro pública)
acceso directo al almacenamiento contiguo subyacente
(función miembro pública)