##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::list::reverse

From cppreference.com
< cpp‎ | container‎ | list

[edit template]

void reverse(); |  |

Reverses the order of the elements in the container. No references or iterators become invalidated.

### [edit] Parameters

(none)

### [edit] Return value

(none)

### [edit] Exceptions

(none) | (until C++11)
`noexcept` specification: noexcept | (since C++11)

### [edit] Complexity

Linear in the size of the container

### [edit] Example

Run this code

    #include <iostream>
    #include <list>

    std::ostream& operator<<(std::ostream& ostr, const std::list<int>& list)
    {
        for (auto &i : list) {
            ostr << " " << i;
        }
        return ostr;
    }

    int main()
    {
        std::list<int> list = { 8,7,5,9,0,1,3,2,6,4 };

        std::cout << "before:     " << list << "\n";
        list.sort();
        std::cout << "ascending:  " << list << "\n";
        list.reverse();
        std::cout << "descending: " << list << "\n";
    }

Output:

    before:      8 7 5 9 0 1 3 2 6 4
    ascending:   0 1 2 3 4 5 6 7 8 9
    descending:  9 8 7 6 5 4 3 2 1 0

### [edit] See also

sort | sorts the elements (public member function) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/container/list/reverse&oldid=50541"
Category:

- unconditionally noexcept

Hidden categories:

- Pages with unreviewed unconditional noexcept template
- Pages with unreviewed noexcept template