std::wcscoll

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

具名要求

Feature test macros (C++20)

语言支持库

Concepts library (C++20)

诊断库

内存管理库

Metaprogramming library (C++11)

通用工具库

容器库

迭代器库

Ranges library (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

Filesystem library (C++17)

Concurrency support library (C++11)

Execution control library (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

Regular expressions library (C++11)

Formatting library (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 );

根据 std::setlocale 最近安装的，由 LC_COLLATE 类别定义的区域设置，比较两个空终止宽字符串。

参数

lhs, rhs

-

指向要比较的空终止宽字符串的指针

返回值

如果 lhs 小于（先于） rhs，则为负值。

​0​ 如果 lhs 等于 rhs。

如果 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 [虚拟]	使用此 facet 的排序规则比较两个字符串 (std::collate<CharT> 的虚拟保护成员函数)
wcsxfrm	转换宽字符串，以便 wcscmp 产生与 wcscoll 相同的结果 (函数)
C 文档 关于 wcscoll 的文档