std::collate<CharT>::transform, do_transform

 

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> 中定义
public: string_type transform( const CharT* low, const CharT* high ) const;	(1)
protected: virtual string_type do_transform( const CharT* low, const CharT* high ) const;	(2)

1) 公共成员函数，调用最派生类别的受保护的虚成员函数 do_transform。

2) 将字符序列 [low, high) 转换为一个字符串，该字符串与对另一个字符串调用 transform() 的结果进行词法比较（例如，使用字符串的 operator<），产生的结果与对相同两个字符串调用 do_compare() 相同。

参数

low	-	指向要转换的序列中的第一个字符的指针
high	-	指向要转换的序列的结束后的指针

返回值

被转换的字符串，以便可以对转换后的字符串进行词法比较，而不是对原始字符串进行排序。在 "C" 区域设置中，返回的字符串是 [low, high) 的完全副本。在其他区域设置中，返回字符串的内容是实现定义的，大小可能长得多。

注释

除了用于排序之外，转换字符串的特定于实现的格式还由 std::regex_traits<>::transform_primary 识别，它能够提取等价类信息。

示例

运行此代码

#include <iomanip>
#include <iostream>
#include <locale>
 
int main()
{
    std::locale::global(std::locale("sv_SE.utf8"));
    auto& f = std::use_facet<std::collate<wchar_t>>(std::locale());
 
    std::wstring in1 = L"\u00e4ngel";
    std::wstring in2 = L"\u00e5r";
 
    std::wstring out1 = f.transform(&in1[0], &in1[0] + in1.size());
    std::wstring out2 = f.transform(&in2[0], &in2[0] + in2.size());
 
    std::wcout << "In the Swedish locale: ";
    if (out1 < out2)
        std::wcout << in1 << " before " << in2 << '\n';
    else
        std::wcout << in2 << " before " << in1 << '\n';
 
    std::wcout << "In lexicographic comparison: ";
    if (in1 < in2)
        std::wcout << in1 << " before " << in2 << '\n';
    else
        std::wcout << in2 << " before " << in1 << '\n';
}

输出

In the Swedish locale: år before ängel
In lexicographic comparison: ängel before år

另请参阅

strxfrm	转换一个字符串，以便 strcmp 将产生与 strcoll 相同的结果 (函数)
wcsxfrm	转换一个宽字符串，以便 wcscmp 将产生与 wcscoll 相同的结果 (函数)