public member function

std::forward_list::front

<forward_list>
      reference front();
const_reference front() const;
Access first element
Returns a reference to the first element in the forward_list container.

Unlike member forward_list::begin, which returns an iterator to this same element, this function returns a direct reference.

Parameters

none

Return value

A reference to the first element in the container.

Member types reference and const_reference are the reference types to the elements of the forward_list container (see member types).

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// forward_list::front
#include <iostream>
#include <forward_list>

int main ()
{
  std::forward_list<int> mylist = {2, 16, 77};

  mylist.front() = 11;

  std::cout << "mylist now contains:";
  for ( int& x : mylist ) std::cout << " " << x;

  std::cout << std::endl;

  return 0;
}


Output:
mylist now contains: 11 16 77

Complexity

Constant.

Iterator validity

No changes.

See also