Skip to content

Search topics & cppreference

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

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

Returns a reference to the first element in the container.

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

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

snippet.cpp
#include <cassert>
#include <vector>
 
int main()
{
    std::vector<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)
direct access to the underlying contiguous storage
(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.