std::forward_list<T,Allocator>:: front
Sequence | ||||
(C++11)
|
||||
(C++26)
|
||||
(C++11)
|
||||
Associative | ||||
Unordered associative | ||||
(C++11)
|
||||
(C++11)
|
||||
(C++11)
|
||||
(C++11)
|
||||
Adaptors | ||||
(C++23)
|
||||
(C++23)
|
||||
(C++23)
|
||||
(C++23)
|
||||
Views | ||||
(C++20)
|
||||
(C++23)
|
||||
Tables | ||||
Iterator invalidation | ||||
Member function table | ||||
Non-member function table |
Member functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Non-member functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Deduction guides (C++17) |
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
>
:
#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) |