Skip to content

Search topics & cppreference

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

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

Returns a reference to the first element in the container.

NotebookLM
reference front();
(1) (since C++11)
const_reference front() const;
(2) (since C++11)

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::forward_list<char>:

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

See also

returns an iterator to the element before beginning
(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.