_strnicmp
, _wcsnicmp
, _mbsnicmp
, _strnicmp_l
, _wcsnicmp_l
, _mbsnicmp_l
大文字小文字に関係なく、2 つの文字列の指定された数の文字を比較します。
重要
_mbsnicmp
および _mbsnicmp_l
は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない 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> で<定義されている戻り値を返_NLSCMPERROR
します>。<
解説
この関数は _strnicmp
、最大で最初の count
文字 string1
と string2
. 比較は、各文字を小文字に変換することで、大文字小文字に関係なく行われます。 _strnicmp
は strncmp
の大文字と小文字を区別しないバージョンです。 count
文字を比較する前に、どちらかの文字列で終端の NULL 文字に到達すると比較は終了します。 count
文字を比較する前に、どちらかの文字列で終端の NULL 文字に到達したときに、文字列が等しい場合は短いほうの文字列が小さくなります。
ASCII テーブルの 91 から 96 までの文字 ('['、'\'、']'、'^'、'_'、'') は、どのアルファベット文字よりも小さいと評価されます。 この順序付けは stricmp
と同じです。
_wcsnicmp
関数と _mbsnicmp
関数は、_strnicmp
関数のワイド文字バージョンとマルチバイト文字バージョンです。 引数 _wcsnicmp
はワイド文字列です。 引数 _mbsnicmp
はマルチバイト文字列です。 _mbsnicmp
は現在のマルチバイト コード ページに基づいてマルチバイト文字のシーケンスを認識し、エラーが発生した場合は _NLSCMPERROR
を返します 詳細については、「コード ページ」を参照してください。 それ以外では、これらの関数の動作は同じです。 これらの関数はロケールの設定の影響を受けます。_l
サフィックスが付いていないバージョンは、ロケールに依存する動作で現在のロケールを使用し、_l
サフィックスが付いているバージョンは、渡される locale
を代わりに使用します。 詳細については、「 Locale」を参照してください。
これらのすべての関数では、パラメーターの検証が行われます。 null ポインターのstring2
string1
場合は、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、これらの関数は _NLSCMPERROR
を返し、errno
を EINVAL
に設定します。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
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> |
互換性の詳細については、「 Compatibility」を参照してください。
例
strncmp
の例を参照してください。
関連項目
文字列操作
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
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示