std::collate

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

本地化库

区域设置和方面
区域设置
has_facet use_facet	locale
方面类别基类
ctype_base codecvt_base messages_base	time_base money_base
ctype 方面
ctype ctype<char> ctype_byname	codecvt codecvt_byname
数字方面
num_get num_put	numpunct numpunct_byname
排序方面
collate	collate_byname
时间方面
time_get time_put	time_get_byname time_put_byname
货币方面
money_get money_put	moneypunct moneypunct_byname
消息方面
messages	messages_byname

字符分类和转换
字符分类
isspace isblank (C++11) iscntrl	isupper islower isalpha	ispunct isdigit isxdigit	isalnum isprint isgraph

字符转换

toupper

tolower

字符串和流转换

wstring_convert (C++11/17/26*)

wbuffer_convert (C++11/17/26*)

文本编码标识

text_encoding (C++26)

Unicode 转换方面

codecvt_utf8 (C++11/17/26*)

codecvt_utf16 (C++11/17/26*)

codecvt_utf8_utf16 (C++11/17/26*)

codecvt_mode (C++11/17/26*)

C 库区域设置
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

std::collate

成员函数

collate::collate

collate::~collate

collate::comparecollate::do_compare

collate::transformcollate::do_transform

collate::hashcollate::do_hash

 

定义在头文件 <locale> 中
template< class CharT > class collate;

类 std::collate 封装了特定于区域设置的字符串排序（比较）和哈希操作。此方面由 std::basic_regex 使用，并且可以通过 std::locale::operator() 直接应用于所有期望字符串比较谓词的标准算法。

继承图

特化

标准库保证提供以下特化（它们需要由任何区域设置对象实现)

定义在头文件 <locale> 中
std::collate<char>	实现字节字符串的字典序排序
std::collate<wchar_t>	实现宽字符串的字典序排序

成员类型

成员类型	定义
char_type	CharT
string_type	std::basic_string<CharT>

成员函数

(构造函数)	构造一个新的 collate 方面 (公有成员函数)
(析构函数)	析构一个 collate 方面 (受保护成员函数)
compare	调用 do_compare (公有成员函数)
transform	调用 do_transform (公有成员函数)
hash	调用 do_hash (公有成员函数)

成员对象

static std::locale::id id

区域设置的 id (公有成员对象)

受保护成员函数

do_compare [虚函数]	使用此方面的排序规则比较两个字符串 (虚函数受保护成员函数)
do_transform [虚函数]	转换字符串，以便排序可以替换为比较 (虚函数受保护成员函数)
do_hash [虚函数]	使用此方面的排序规则生成一个整数哈希值 (虚函数受保护成员函数)

示例

运行此代码

#include <algorithm>
#include <iostream>
#include <locale>
#include <string>
#include <vector>
 
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    std::wcout.imbue(std::locale(""));
    std::vector<std::wstring> v{
        L"ar", L"zebra", L"\u00f6grupp", L"Zebra",
        L"\u00e4ngel",L"\u00e5r", L"f\u00f6rnamn"
    };
 
    std::wcout << "Default locale collation order: ";
    std::sort(v.begin(), v.end());
    for (auto s : v)
        std::wcout << s << ' ';
    std::wcout << '\n';
 
    std::wcout << "English locale collation order: ";
    std::sort(v.begin(), v.end(), std::locale("en_US.UTF-8"));
    for (auto s : v)
        std::wcout << s << ' ';
    std::wcout << '\n';
 
    std::wcout << "Swedish locale collation order: ";
    std::sort(v.begin(), v.end(), std::locale("sv_SE.UTF-8"));
    for (auto s : v)
        std::wcout << s << ' ';
    std::wcout << '\n';
}

输出

Default locale collation order: Zebra ar förnamn zebra ängel år ögrupp
English locale collation order: ängel ar år förnamn ögrupp zebra Zebra
Swedish locale collation order: ar förnamn zebra Zebra år ängel ögrupp

另请参阅

operator()	使用此区域设置的排序方面按字典顺序比较两个字符串 (std::locale 的公有成员函数)
collate_byname	表示命名区域设置的系统提供的 std::collate (类模板)