std::wcscoll

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

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

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

原生数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码标识

text_encoding (C++26)

 

空终止宽字符串

函数
字符分类
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
字符操作
towlower towupper	towctrans wctrans
转换为数字格式
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
字符串操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
字符串检查
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
数组操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
类型 wctrans_t wctype_t wint_t	宏 WCHAR_MIN WCHAR_MAX WEOF

 

在头文件 <cwchar> 中定义
int wcscoll( const wchar_t* lhs, const wchar_t* rhs );

根据 LC_COLLATE 类别，使用最近由 std::setlocale 安装的区域设置比较两个以空字符结尾的宽字符串。

参数

lhs, rhs

-

指向要比较的以空字符结尾的宽字符串的指针

返回值

如果 lhs 小于（在前面） rhs，则返回负值。

如果 lhs 等于 rhs，则返回 ​0​。

如果 lhs 大于（在后面） rhs，则返回正值。

注意

排序顺序是字典顺序：字母在国家字母表中的位置（其 等价类）具有比其大小写或变体更高的优先级。在等价类中，小写字符在对应的大写字符之前排序，并且特定于区域设置的顺序可能适用于带变音符号的字符。在某些区域设置中，字符组作为一个 排序单元 进行比较。例如，捷克语中的 "ch" 位于 "h" 之后，"i" 之前；匈牙利语中的 "dzs" 位于 "dz" 之后，"g" 之前。

示例

运行此代码

#include <clocale>
#include <iostream>
 
void try_compare(const wchar_t* p1, const wchar_t* p2)
{
    if (std::wcscoll(p1, p2) < 0)
        std::wcout << p1 << " before " << p2 << '\n';
    else
        std::wcout << p2 << " before " << p1 << '\n';
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "cs_CZ.utf8");
    std::wcout << "In the Czech locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"år", L"ängel");
 
    std::setlocale(LC_COLLATE, "sv_SE.utf8");
    std::wcout << "In the Swedish locale: ";
    try_compare(L"år", L"ängel");
}

输出

In the American locale: chrt before hrnec
In the Czech locale: hrnec before chrt
In the American locale: ängel before år
In the Swedish locale: år before ängel

另请参阅

strcoll	根据当前区域设置比较两个字符串 (函数)
do_compare [virtual]	使用此 facet 的排序规则比较两个字符串 (std::collate<CharT> 的虚保护成员函数)
wcsxfrm	转换宽字符串，使 wcscmp 产生与 wcscoll 相同的结果 (函数)
C 文档 为 wcscoll