次の方法で共有


_strnicoll、_wcsnicoll、_mbsnicoll、_strnicoll_l、_wcsnicoll_l、_mbsnicoll_l

更新 : 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 に設定します。

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

TCHAR.H のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_tcsncicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll_l

_strnicoll_l

_mbsnbicoll_l

_wcsnicoll_l

必要条件

ルーチン

必須ヘッダー

_strnicoll, _strnicoll_l

<string.h>

_wcsnicoll, _wcsnicoll_l

<wchar.h> または <string.h>

_mbsnicoll, _mbsnicoll_l

<mbstring.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

.NET Framework の相当するアイテム

System::String::Compare

参照

参照

ロケール

文字列操作 (CRT)

strcoll 系関数

localeconv

_mbsnbcoll、_mbsnbcoll_l、_mbsnbicoll、_mbsnbicoll_l

setlocale、_wsetlocale

strcmp、wcscmp、_mbscmp

_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l

strncmp、wcsncmp、_mbsncmp、_mbsncmp_l

_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l

strxfrm、wcsxfrm、_strxfrm_l、_wcsxfrm_l