wcscmp

2つのヌル終端ワイド文字列を辞書順に比較します。

結果の符号は、比較対象の文字列において最初に異なるワイド文字の値の差の符号と一致します。

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 [ざいます]

参考文献

関連項目