_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l

[アーティクル]
03/26/2013

ケースに関係なく、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
使用するロケール。

戻り値

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

戻り値	説明
< 0	string1 部分文字列は string2 部分文字列未満です。
0	string1 部分文字列は string2 部分文字列と同じものです。
> 0	string1 部分文字列は string2 部分文字列より大きい。

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

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

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcsncicmp	_strnicmp	_mbsnicmp	_wcsnicmp
_tcsnicmp	_strnicmp	_mbsnbicmp	_wcsnicmp
_tcsncicmp_l	_strnicmp_l	_mbsnicmp_l	_wcsnicmp_l

必要条件

ルーチン	必須ヘッダー
_strnicmp, _strnicmp_l	<string.h>
_wcsnicmp, _wcsnicmp_l	<string.h> または <wchar.h>
_mbsnicmp, _mbsnicmp_l	<mbstring.h>

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

次の方法で共有

_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l

パラメーター

戻り値

解説

必要条件

使用例

同等の .NET Framework 関数

参照

関連項目

その他のリソース