_strnicoll、_wcsnicoll、_mbsnicoll、_strnicoll_l、_wcsnicoll_l、_mbsnicoll_l

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ロケール固有の情報を使って文字列を比較します。

int _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

パラメータ

string1, string2
比較対象となる、NULL で終わる文字列。
count
比較する文字数。
locale
使用するロケール。

戻り値

これらの関数は、次のように string1 と string2 の部分文字列の関係を示す値を返します。

戻り値	string1 と string2 の関係
< 0	string1 buf1 は buf2 より小さいstring2
0	string1 string1 と string2 は等しいstring2
> 0	string1 buf1 は buf2 より大きいstring2

これらの各関数は _NLSCMPERROR を返します。_NLSCMPERROR を使用するには、STRING.H または MBSTRING.H をインクルードします。string1 または string2 に照合順序のドメイン外のワイド文字コードが含まれていると、_wcsnicoll が失敗することがあります。_wcsnicoll 関数は、エラーが発生した場合、グローバル変数 errno に EINVAL を設定することがあります。_wcsnicoll 関数の呼び出しエラーを調べるには、errno を 0 に設定し、_wcsnicoll 関数を呼び出してから errno の値を確認します。

解説

各関数は、コードページに基づいて、大文字と小文字を区別せずに string1 と string2 の最初の count 文字を比較します。これらの関数は、コードページで文字セットの文字順と辞書式の文字順が異なり、その違いが文字列を比較するときに問題になる場合のみ使用してださい。_l サフィックスが付いていないバージョンは、現在のロケールとコードページを使用します。 _l サフィックスが付いているバージョンは、渡されたロケールを代わりに使用することを除いて同じです。詳細については、「ロケール」を参照してください。

これらすべての関数で、パラメータが検証されます。string1 または string2 が null ポインタの場合、または count が INT_MAX より大きい場合、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、これらの関数は _NLSCMPERROR を返し、errno を EINVAL に設定します。

汎用テキストルーチンのマップ