std::wcscmp

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

字符串库

以 null 结尾的字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

以 null 结尾的宽字符串

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

 

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

以字典序比较两个以 null 结尾的宽字符串。

结果的符号是两个字符串中第一个不同的宽字符对的值的差的符号。

如果 lhs 或 rhs 不是指向以 null 结尾的宽字符串的指针，则行为未定义。

参数

lhs, rhs

-

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

返回值

如果 lhs 在字典序中出现在 rhs 之前，则为负值。

如果 lhs 和 rhs 相等，则为零。

如果 lhs 在字典序中出现在 rhs 之后，则为正值。

说明

与 std::wcscoll 不同，此函数不依赖区域设置，当使用来自不同 Unicode 块的字符或代码单位的顺序不匹配排序顺序时，顺序可能没有意义。

示例

运行这段代码

#include <algorithm>
#include <cwchar>
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<const wchar_t*> leaders{L"Ленин", L"Сталин", L"Маленков",
        L"Хрущёв", L"Брежнев", L"Андропов", L"Черненко", L"Горбачёв"};
 
    std::ranges::sort(leaders, [](auto leaderLHS, auto leaderRHS)
    {
        return std::wcscmp(leaderLHS, leaderRHS) < 0;
    });
 
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    for (auto leader : leaders)
        std::wcout << leader << '\n';
}

可能的输出

Андропов
Брежнев
Горбачёв
Ленин
Маленков
Сталин
Хрущёв
Черненко

参见

wcsncmp	比较两个宽字符串中的特定数量的字符 (函数)
wmemcmp	比较两个数组中的特定数量的宽字符 (函数)
strcmp	比较两个字符串 (函数)
wcscoll	根据当前区域设置比较两个宽字符串 (函数)
C 文档 for wcscmp