_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l

ケースに関係なく、2 文字の文字列を比較します。

重要
_mbsnicmp と _mbsnicmp_l は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。

int _strnicmp(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

パラメーター

• string1, string2
  比較する、NULL で終わる文字列。

• count
  比較する文字数。

• locale
  使用するロケール。

戻り値

部分文字列間の関係を、次のように表示されます。

STRING.H と MBSTRING.H.で定義されるエラーで、_mbsnicmp は _NLSCMPERRORを返します。

解説

_strnicmp 関数は、辞書式に、最大で、string1 の count の最初の文字と string2を比較します。比較は、ケースに関係なく行われます; _strnicmp は strncmpのケースと小文字を区別しないバージョンです。比較は count の文字を比較する前に、終端の NULL 文字は、どちらの文字列が到達すると終了します。count の文字を比較する前に、終端の NULL 文字は、どちらの文字列が到達すると、文字列が等しい場合、短い文字列はより小さい。

91 から 96 までの ASCII の表は、任意の英字文字未満 ( "["、"\"、"]"、"^"、"_"、" "、および" ) 評価されます。命令によって、stricmpの名前と同じです。

_wcsnicmp 関数と _mbsnicmp 関数は、_strnicmp 関数のワイド文字バージョンとマルチバイト文字バージョンです。_wcsnicmp 関数の引数と戻り値はワイド文字列で、_mbsnicmp 関数の引数と戻り値はマルチバイト文字列です。_mbsnicmp は、現在のマルチバイト コード ページに従ってマルチバイト文字シーケンスを認識し、エラーの _NLSCMPERROR を返します。詳細については、「コード ページ」を参照してください。それ以外では、これらの関数の動作は同じです。これらの関数は _l のサフィックスの使用がロケール依存の動作の現在のロケールないロケール設定のバージョンによって決まります。; _l のサフィックスを渡されたロケールを使用する代わりに、バージョン。詳細については、「ロケール」を参照してください。

これらの関数はすべて、パラメーターを検証します。string1string2 またはが null ポインターの場合、無効なパラメーター ハンドラーが パラメーターの検証に説明されているように、開始されます。実行の継続が許可された場合、これらの関数は _NLSCMPERROR を返し、errno を EINVAL に設定します。

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

必要条件

追加の互換性の詳細については、互換性を参照してください。

使用例

strncmpの例を参照してください。

同等の .NET Framework 関数

System::String::Compare

参照

関連項目

文字列操作 (CRT)

strcat、wcscat、_mbscat

strcmp、wcscmp、_mbscmp

strcpy、wcscpy、_mbscpy

strncat、_strncat_l、wcsncat、wcsncat_l、_mbsncat、_mbsncat_l

strncmp、wcsncmp、_mbsncmp、_mbsncmp_l

strncpy、_strncpy_l、wcsncpy、_wcsncpy_l、_mbsncpy、_mbsncpy_l

strrchr、wcsrchr、_mbsrchr、_mbsrchr_l

_strset、_strset_l、_wcsset、_wcsset_l、_mbsset、_mbsset_l

strspn、wcsspn、_mbsspn、_mbsspn_l