wcscmp

来自cppreference.com
< c‎ | string‎ | wide
在标头 <wchar.h> 定义
int wcscmp( const wchar_t* lhs, const wchar_t* rhs );
(C95 起)

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

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

lhsrhs 不是指向空终止宽字符串的指针,则行为未定义。

参数

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

返回值

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

lhsrhs 比较相等则为零。

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

注意

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

示例

#include <locale.h>
#include <stdio.h>
#include <wchar.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 [ざいます]

引用

  • C23 标准(ISO/IEC 9899:2024):
  • 7.29.4.4.1 The wcscmp function (第 TBD 页)
  • C17 标准(ISO/IEC 9899:2018):
  • 7.29.4.4.1 The wcscmp function (第 TBD 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 7.29.4.4.1 The wcscmp function (第 433 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.24.4.4.1 The wcscmp function (第 379 页)

参阅

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