Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

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

Returns a reference to the first element in the container.

Containers
  • C++98
  • C++11
1 min readView on cppreference
NotebookLM
reference front();
(1)
const_reference front() const;
(2)

Returns a reference to the first element in the container.

Calling front on an empty container causes undefined behavior.

Parameters

(none)

Return value

Reference to the first element.

Complexity

Constant.

Notes

For a container c, the expression c.front() is equivalent to *c.begin().

Example

The following code uses front to display the first element of a std::deque<char>:

snippet.cpp
#include <cassert>
#include <deque>
 
int main()
{
    std::deque<char> letters{'a', 'b', 'c', 'd'};
    assert(letters.front() == 'a');
}

See also

access the last element
(public member function)
(C++11)
returns a reverse iterator to the end
(public member function)
returns an iterator to the beginning
(public member function)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.