Compartilhar via


queue::front

Retorna uma referência ao primeiro elemento na frente da fila.

reference front( );
const_reference front( ) const;

Valor de retorno

O primeiro elemento da fila. Se a fila estiver vazia, o valor de retorno será indefinido.

Comentários

Se o valor de retorno de front é atribuído a const_reference, o objeto da fila não pode ser alterado. Se o valor de retorno de front é atribuído a reference, o objeto de fila pode ser alterado.

A função de membro retorna reference ao primeiro elemento da sequência controlada, que deve ser não vazio.

Ao criar com _SECURE_SCL 1, um erro de tempo de execução ocorrerá se você tentar acessar um elemento em uma fila vazia. Consulte Iteradores Verificados para maiores informações.

Exemplo

// queue_front.cpp
// compile with: /EHsc
#include <queue>
#include <iostream>

int main() {
   using namespace std;
   queue <int> q1;

   q1.push( 10 );
   q1.push( 20 );
   q1.push( 30 );

   queue <int>::size_type i;
   i = q1.size( );
   cout << "The queue length is " << i << "." << endl;

   int& ii = q1.back( );
   int& iii = q1.front( );

   cout << "The integer at the back of queue q1 is " << ii 
        << "." << endl;
   cout << "The integer at the front of queue q1 is " << iii 
        << "." << endl;
}

Saída

The queue length is 3.
The integer at the back of queue q1 is 30.
The integer at the front of queue q1 is 10.

Requisitos

fila <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe queue

Funções queue

Biblioteca de Modelos Padrão