wcscmp

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

结果的符号取决于被比较字符串中第一对不同的宽字符值之间的差值符号。

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

参数

返回值

若 lhs 在字典序中出现在 rhs 之前，则返回负值。

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

正值表示 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 [ざいます]

参考文献

参见