Namespaces
Variants

std::list<T,Allocator>:: sort

From cppreference.net

C++
Containers library
std::list
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
void sort ( ) ;
(1) (自 C++26 起为 constexpr)
template < class Compare >
void sort ( Compare comp ) ;
(2) (自 C++26 起为 constexpr)

对元素进行排序并保持等价元素的顺序。如果抛出异常， * this 中元素的顺序是未指定的。

1) 元素使用 operator < 进行比较。
2) 元素使用 comp 进行比较。

不会使任何引用或迭代器失效。

目录

参数

comp - 比较函数对象（即满足 Compare 要求的对象），当第一个参数 小于 （即排序在之前）第二个参数时返回​ true 。

比较函数的签名应等价于如下形式：

bool cmp ( const Type1 & a, const Type2 & b ) ;

虽然签名不需要包含 const & ，但函数不得修改传递给它的对象，且必须能够接受所有（可能为const的） Type1 和 Type2 类型的值，无论其 值类别 如何（因此不允许使用 Type1& ，也不允许使用 Type1 ，除非对于 Type1 类型移动操作等同于拷贝操作 (C++11 起) ）。
类型 Type1 和 Type2 必须满足： list < T,Allocator > :: const_iterator 类型的对象在解引用后能隐式转换到这两个类型。 ​

类型要求
-
Compare 必须满足 Compare 的要求。

复杂度

给定 N 作为 size() ：

1) 大约需要 N·log(N) 次比较（使用 operator < ）。
2) 大约需要 N·log(N) 次比较函数 comp 的应用。

注释

std::sort 需要随机访问迭代器，因此不能用于 list 。此函数与 std::sort 的不同之处在于：它不要求 list 的元素类型可交换，会保留所有迭代器的值，并执行稳定排序。

示例

运行此代码 
#include <functional>
#include <iostream>
#include <list>
std::ostream& operator<<(std::ostream& ostr, const std::list<int>& list)
{
    for (const int i : list)
        ostr << ' ' << i;
    return ostr;
}
int main()
{
    std::list<int> list{8, 7, 5, 9, 0, 1, 3, 2, 6, 4};
    std::cout << "初始状态: " << list << '\n';
    list.sort();
    std::cout << "升序排列: " << list << '\n';
    list.sort(std::greater<int>());
    std::cout << "降序排列:" << list << '\n';
}

输出： 

初始状态:  8 7 5 9 0 1 3 2 6 4
升序排列:  0 1 2 3 4 5 6 7 8 9
降序排列: 9 8 7 6 5 4 3 2 1 0

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

缺陷报告 适用范围 发布时行为 正确行为
LWG 1207 C++98 未明确说明迭代器和/或引用是否失效 保持有效

参见

反转元素的顺序
(公开成员函数)