public member function
<list>

std::list::reverse

void reverse();
void reverse() noexcept;
Reverse the order of elements
Reverses the order of the elements in the list container.

Parameters

none

Return value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// reversing list
#include <iostream>
#include <list>

int main ()
{
  std::list<int> mylist;

  for (int i=1; i<10; ++i) mylist.push_back(i);

  mylist.reverse();

  std::cout << "mylist contains:";
  for (std::list<int>::iterator it=mylist.begin(); it!=mylist.end(); ++it)
    std::cout << ' ' << *it;

  std::cout << '\n';

  return 0;
}


Output:
mylist contains: 9 8 7 6 5 4 3 2 1

Complexity

Linear in list size.

Iterator validity

No changes.

Data races

The container is modified.
No contained elements are accessed: concurrently accessing or modifying them is safe, although iterating through the container is not.

Exception safety

No-throw guarantee: this member function never throws exceptions.

See also