命名空间
变体
操作

wcscmp

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

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

结果的符号是正在比较的字符串中第一个不同的宽字符对的值之间的差的符号。

如果 lhsrhs 不是指向以 null 结尾的宽字符串的指针,则行为未定义。

内容

[编辑] 参数

lhs, rhs - 指向要比较的以 null 结尾的宽字符串的指针

[编辑] 返回值

如果 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 wcscmp 函数 (p: 待定)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.29.4.4.1 wcscmp 函数 (p: 待定)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.29.4.4.1 wcscmp 函数 (p: 433)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.24.4.4.1 wcscmp 函数 (p: 379)

[编辑] 另请参见

比较两个宽字符串中的特定数量的字符
(函数) [编辑]
比较两个数组中的特定数量的宽字符
(函数) [编辑]
比较两个字符串
(函数) [编辑]
根据当前区域设置比较两个宽字符串
(函数) [编辑]
C++ 文档 for wcscmp