wcscmp_C语言中文网

C 参考手册

定义于头文件 `<wchar.h>`
int wcscmp( const wchar_t lhs, const wchar_t rhs );		(C95 起)

以字典序比较二个空终止宽字符串。

结果的符号是被比较的字符串中，首对相异宽字符间的差值符号。

若 lhs 或 rhs 不是指向空终止宽字符串的指针，则行为未定义。

参数

lhs, rhs	-	指向待比较的空终止宽字符串的指针

返回值

若字典序中 lhs 先出现于 rhs 则为负值。

若 lhs 与 rhs 比较相等则为零。

若字典序中 lhs 后出现于 rhs 则为负值。

注意

不同于 wcscoll ，此函数不考虑本地环境。而且在一同使用来自不同的 Unicode 块的字符时，或编码单元不匹配任何对照顺序时，顺序可能无意义。

示例

运行此代码

#include <wchar.h>
#include <stdio.h>
#include <locale.h>
 
void demo(const wchar_t* lhs, const wchar_t* rhs)
{
    int rc = wcscmp(lhs, rhs);
    const char *rel = rc < 0 ? "precedes" : rc > 0 ? "follows" : "equals";
 
    setlocale(LC_ALL, "en_US.utf8");
    printf("[%ls] %s [%ls]\n", lhs, rel, rhs);
}
 
int main(void)
{
    const wchar_t* string = L"どうもありがとうございます";
    demo(string, L"どうも");
    demo(string, L"助かった");
    demo(string + 9, L"ありがとうございます" + 6);
}

可能的输出：

[どうもありがとうございます] follows [どうも]
[どうもありがとうございます] precedes [助かった]
[ざいます] equals [ざいます]

引用

C11 standard (ISO/IEC 9899:2011):

7.29.4.4.1 The wcscmp function (p: 433)

C99 standard (ISO/IEC 9899:1999):

7.24.4.4.1 The wcscmp function (p: 379)

参阅

wcsncmp (C95)	比较来自两个宽字符串的一定量字符 (函数)
wmemcmp (C95)	比较两个数组中一定数量的宽字符 (函数)
strcmp	比较两个字符串 (函数)
wcscoll (C95)	根据当前本地环境比较两个宽字符串 (函数)