list::back and list::front

MSDN Library
Development Tools and Languages
Visual Studio 2008
Visual Studio
Visual C++
Visual C++ Reference
Visual C++ Libraries Reference
Standard C++ Library
Standard Template Library Samples

abs (STL Samples)
accumulate, copy, and vector::push_back
adjacent_difference and vector::push_back
advance (STL Samples)
Basic Math Functions
basic_string::append (STL Samples)
basic_string::find_first_of (STL Samples)
basic_string::size and basic_string::resize
binary_function Structure Sample
count (STL Samples)
count_if (STL Samples)
deque::assign and deque::swap
deque::begin and deque::end
deque::erase and deque::clear
deque::front and deque::back
deque::insert (STL Samples)
deque::operator[] and deque::at
deque::operator== and deque::operator<
deque::push_back and deque::pop_back
deque::push_front and deque::pop_front
deque::rbegin and deque::rend
deque::size and deque::resize
distance (STL Samples)
exp, log, and log10
find (STL Samples)
find_if (STL Samples)
for_each (STL Samples)
generate (STL Samples)
generate_n (STL Samples)
heap
includes (STL Samples)
inner_product (STL Samples)
inplace_merge (STL Samples)
iter_swap (STL Samples)
list::assign (STL Samples)

list::back and list::front
This page is specific to:.NET Framework Version:1.1 2.03.54.0

Visual C++ Standard Library

list::back and list::front

Illustrates how to use the list::back and list::front Standard Template Library (STL) functions in Visual C++.

reference back( ); 
const_reference back( ) const; 
reference front( ); 
const_reference front( ) const; 
void pop_back( ); 
void pop_front( ); 
void push_back(
   const T& x
);
void push_front(
   const T& x
);

Remarks

Note:
The class/parameter names in the prototype do not match the version in the header file. Some have been modified to improve readability.

The back member function returns a reference to the last element of the controlled sequence. The front member function returns a reference to the first element of the controlled sequence. The pop_back member function removes the last element of the controlled sequence. The pop_front member function removes the first element of the controlled sequence. All these functions require that the controlled sequence be nonempty. The push_back member function inserts an element with value x at the end of the controlled sequence. The push_front member function inserts an element with value x at the beginning of the controlled sequence.

Example

// liststck.cpp
// compile with: /EHsc
//  This example shows how to use the various stack
//                 like functions of list.
//
// Functions:
//    list::back
//    list::front
//    list::pop_back
//    list::pop_front
//    list::push_back
//    list::push_front

#pragma warning (disable:4786)
#include <list>
#include <string>
#include <iostream>

using namespace std ;

typedef list<string> LISTSTR;

int main()
{
    LISTSTR test;

    test.push_back("back");
    test.push_front("middle");
    test.push_front("front");

    // front
    cout << test.front() << endl;

    // back
    cout << test.back() << endl;

    test.pop_front();
    test.pop_back();

    // middle
    cout << test.front() << endl;
}

Output

front
back
middle

Requirements

Header: <list>

Concepts

Standard Template Library Samples