QCollator Class

QStringList sortedStrings(QStringList seq)
{
    QCollator order;
    std::sort(seq.begin(), seq.end(), order);
    return seq;
}

成员函数文档

QCollator::QCollator()

使用默认区域设置的排序区域设置来构建一个 QCollator 对象。

当系统区域设置用作默认区域设置时，其排序区域设置可能与其自身不同（例如在 Unix 系统中，如果环境变量 LC_COLLATE 的设置与 LANG 不同）。所有其他区域设置均以其自身作为排序区域设置。

另请参阅 setLocale()、QLocale::collation() 和QLocale::setDefault()。

[explicit] QCollator::QCollator(const QLocale &locale)

使用给定的locale 构建一个QCollator。

另请参阅 setLocale()。

QCollator::QCollator(const QCollator &other)

创建other 的副本。

[noexcept] QCollator::QCollator(QCollator &&other)

移动构造函数。将数据从other 移动到此排序器中。

[noexcept] QCollator::~QCollator()

销毁此排序器。

Qt::CaseSensitivity QCollator::caseSensitivity() const

返回排序器的区分大小写设置。

在设置之前，默认行为是区分大小写。

另请参阅 setCaseSensitivity()。

int QCollator::compare(QStringView s1, QStringView s2) const

比较s1 与s2 。

如果s1 小于s2 ，则返回一个负整数；如果大于s2 ，则返回一个正整数；如果两者相等，则返回零。

int QCollator::compare(const QString &s1, const QString &s2) const

int QCollator::compare(const QChar *s1, qsizetype len1, const QChar *s2, qsizetype len2) const

比较s1 与s2 。len1 和len2 分别指定由s1 和s2 所指向的QChar 数组的长度。

如果s1 小于s2 ，则返回一个负整数；如果大于s2 ，则返回一个正整数；如果两者相等，则返回零。

[static, since 6.3] int QCollator::defaultCompare(QStringView s1, QStringView s2)

比较字符串s1 和s2 ，并返回它们的排序顺序。该函数对默认构造的QCollator 对象执行的操作与compare()相同。

该函数于 Qt 6.3 中引入。

另请参阅 compare() 和defaultSortKey()。

[static, since 6.3] QCollatorSortKey QCollator::defaultSortKey(QStringView key)

返回字符串key 的排序键。该函数对默认构造的QCollator 对象执行的操作与sortKey()相同。

该函数在 Qt 6.3 中引入。

另请参阅 sortKey() 和defaultCompare()。

bool QCollator::ignorePunctuation() const

返回在排序时是否忽略标点符号和特殊字符。

当true 时，字符串的比较将视同于从每个字符串中移除了所有标点符号和特殊字符。

另请参阅 ` setIgnorePunctuation()`。

QLocale QCollator::locale() const

返回排序器的区域设置。

除非在构造函数中指定或通过调用setLocale()进行设置，否则将使用系统的默认排序区域设置。

另请参阅 setLocale() 和QLocale::collation()。

bool QCollator::numericMode() const

如果启用了数值排序，则返回 `true `；否则返回 `false `。

当true 时，数字会被识别为数值并按算术顺序排序；例如，100 排在 99 之后。当false 时，数字按字典顺序排序，因此 100 排在 99 之前（因为 1 在 9 之前）。默认情况下，此选项处于禁用状态。

另请参阅 setNumericMode()。

void QCollator::setCaseSensitivity(Qt::CaseSensitivity cs)

将排序器的区分大小写设置为cs 。

另请参阅 caseSensitivity()。

void QCollator::setIgnorePunctuation(bool on)

如果on 的值为true ，则忽略标点符号和特殊字符；如果false ，则处理它们。

另请参阅 ignorePunctuation()。

void QCollator::setLocale(const QLocale &locale)

将排序器的区域设置为locale 。

另请参阅 locale()。

void QCollator::setNumericMode(bool on)

当on 的值为true 时，启用数值排序模式。

另请参阅 numericMode()。

QCollatorSortKey QCollator::sortKey(const QString &string) const

返回一个用于 `string` 的排序键。

创建排序键通常比直接使用 `compare()` 方法稍慢一些。但如果需要反复比较该字符串（例如在对整个字符串列表进行排序时），通常先为每个字符串创建排序键，然后使用这些键进行排序会更快。

[noexcept] void QCollator::swap(QCollator &other)

将此排序器与other 互换。此操作速度极快，且绝不会失败。

bool QCollator::operator()(QStringView s1, QStringView s2) const

QCollator 可以作为排序算法的比较函数。如果s1 排在s2 之前，则返回true ；否则返回false 。

另请参阅 compare()。

bool QCollator::operator()(const QString &s1, const QString &s2) const

[noexcept] QCollator &QCollator::operator=(QCollator &&other)

将other 通过移动赋值操作赋值给此QCollator 实例。

QCollator &QCollator::operator=(const QCollator &other)

将other 分配给此排序器。