deque::back

Returns a reference to the last element of the deque.

reference back( ); 
const_reference back( ) const;

Return Value

The last element of the deque. If the deque is empty, the return value is undefined.

Remarks

If the return value of back is assigned to a const_reference, the deque object cannot be modified. If the return value of back is assigned to a reference, the deque object can be modified.

When compiling with _SECURE_SCL 1, a runtime error will occur if you attempt to access an element in an empty deque. See Checked Iterators for more information.

Example

// deque_back.cpp
// compile with: /EHsc
#include <deque>
#include <iostream>

int main( ) 
{
   using namespace std;
   deque <int> c1;
   
   c1.push_back( 10 );
   c1.push_back( 11 );

   int& i = c1.back( );
   const int& ii = c1.front( );

   cout << "The last integer of c1 is " << i << endl;
   i--;
   cout << "The next-to-last integer of c1 is " << ii << endl;
}

Output

The last integer of c1 is 11
The next-to-last integer of c1 is 10

Requirements

Header: <deque>

Namespace: std

See Also

Concepts

deque Class

deque Class Members

deque::front and deque::back

Standard Template Library