| 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>:
#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) |
| (C++11) |
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.