wcsncmp

最大で count 個のワイド文字を、2つのヌル終端ワイド文字列で比較します。比較は辞書順で行われます。

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

lhs または rhs がヌル終端文字列へのポインタでない場合、動作は未定義です。

パラメータ

戻り値

lhs が rhs より辞書順で前に現れる場合は負の値。

lhs と rhs が等しく比較される場合はゼロ。

lhs が rhs より辞書順で後に現れる場合、正の値。

注記

この関数はロケール依存ではありません。 wcscoll および wcsxfrm とは異なります。

例

#include <stdio.h>
#include <wchar.h>
#include <locale.h>
void demo(const wchar_t *lhs, const wchar_t *rhs, int sz)
{
    int rc = wcsncmp(lhs, rhs, sz);
    if(rc == 0)
        printf("First %d characters of [%ls] equal [%ls]\n", sz, lhs, rhs);
    else if(rc < 0)
        printf("First %d characters of [%ls] precede [%ls]\n", sz, lhs, rhs);
    else if(rc > 0)
        printf("First %d characters of [%ls] follow [%ls]\n", sz, lhs, rhs);
}
int main(void)
{
    const wchar_t *str1 = L"안녕하세요";
    const wchar_t *str2 = L"안녕히 가십시오";
    setlocale(LC_ALL, "en_US.utf8");
    demo(str1, str2, 5);
    demo(str2, str1, 8);
    demo(str1, str2, 2);
}

First 5 characters of [안녕하세요] precede [안녕히 가십시오]
First 8 characters of [안녕히 가십시오] follow [안녕하세요]
First 2 characters of [안녕하세요] equal [안녕히 가십시오]

参考文献