wcscmp

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

结果的符号是所比较的字符串中第一对宽字符值不同的标志。

如果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);
 
    setlocale(LC_ALL, "en_US.utf8");
    if(rc == 0)
        printf("[%ls] equals [%ls]\n", lhs, rhs);
    else if(rc < 0)
        printf("[%ls] precedes [%ls]\n", lhs, rhs);
    else if(rc > 0)
        printf("[%ls] follows [%ls]\n", lhs, rhs);
 
}
int main(void)
{
    const wchar_t* string = L"どうもありがとうございます";
    demo(string, L"どうも");
    demo(string, L"助かった");
    demo(string + 9, L"ありがとうございます" + 6);
}

​

可能的输出：

​

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

​

参考

• 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）

另请参阅

| 针对wcscmp |的C ++文档