_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l
文字列を小文字を区別しない比較を実行します。
重要 |
---|
_mbsicmp と _mbsicmp_l は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
int _stricmp(
const char *string1,
const char *string2
);
int _wcsicmp(
const wchar_t *string1,
const wchar_t *string2
);
int _mbsicmp(
const unsigned char *string1,
const unsigned char *string2
);
int _stricmp_l(
const char *string1,
const char *string2,
_locale_t locale
);
int _wcsicmp_l(
const wchar_t *string1,
const wchar_t *string2,
_locale_t locale
);
int _mbsicmp_l(
const unsigned char *string1,
const unsigned char *string2,
_locale_t locale
);
パラメーター
string1, string2
比較する、NULL で終わる文字列。locale
使用するロケール。
戻り値
戻り値は string2 に string1 の関係を次のように表示されます。
戻り値 |
説明 |
---|---|
< 0 |
string1string2未満 |
0 |
string2と同一 のstring1 |
> 0 |
string2より大きいstring1 |
STRING.H と MBSTRING.H.で定義されるエラーで、_mbsicmp は _NLSCMPERRORを返します。
解説
_stricmp関数は、辞書式に string1 と string2 の小文字のバージョンを比較し、関係を示す値を返します。_stricmpは _stricollと _stricollの比較がロケールに LC_CTYPEと LC_COLLATEのカテゴリに従ってあり _stricmpの比較が LC_CTYPEの影響を受ける可能性は異なります。LC_COLLATEのカテゴリの詳細については、[setlocale] と ロケール カテゴリを参照してください。_l のサフィックスを使用しないこれらの関数の各バージョンはロケールに依存する動作に現在のロケールを使用します。サフィックスのバージョンは同じですが、代わりに渡されたロケールを使用します。詳細については、「ロケール」を参照してください。
[!メモ]
_stricmp は _strcmpi と同じ意味です。これらは交換して使用できますが、_stricmp は、標準です。
_strcmpi関数は _stricmpと等価であり、下位互換性のためだけに残されています。
stricmp は小文字を区別しない比較を行うため、予期しない動作が発生する場合があります。
2 番目の文字列と JOHN_HENRY Johnson があると stricmp によるケースの変換は比較の結果に影響するかについてするには、仮定します。 "_" に小文字の ASCII の S より小さい値を持つため、文字列 JOHN_HENRY は、Johnson 未満であると見なされます。実際、91 の ASCII 値があり、96 を考慮する文字未満と文字。
strcmp 関数が stricmpの代わりにを使用すると、JOHN_HENRY は、Johnson より大きい。
_wcsicmp 関数と _mbsicmp 関数は、_stricmp 関数のワイド文字バージョンとマルチバイト文字バージョンです。_wcsicmp 関数の引数と戻り値はワイド文字列で、_mbsicmp 関数の引数と戻り値はマルチバイト文字列です。_mbsicmp は、現在のマルチバイト コード ページに従ってマルチバイト文字シーケンスを認識し、エラーの _NLSCMPERROR を返します。(詳細については、コード ページを参照してください)。それ以外では、これらの関数の動作は同じです。
_wcsicmp と wcscmp には同じですが、wcscmp は小文字と比較する前に、引数を変換しません。_mbsicmp と _mbscmp には同じですが、_mbscmp は小文字と比較する前に、引数を変換しません。
ラテン語 1 文字を使用するように _wcsicmp の [setlocale] を呼び出す必要があります。C のロケールは、既定で有効になります (順序は Ä に等しいは比較されません。_wcsicmpに呼び出しの前に C のロケール以外のロケールで setlocale を呼び出します。次の例ではロケールに依存 _wcsicmpがどのように使用されるかを示します:
// crt_stricmp_locale.c
#include <string.h>
#include <stdio.h>
#include <locale.h>
int main() {
setlocale(LC_ALL,"C"); // in effect by default
printf("\n%d",_wcsicmp(L"ä", L"Ä")); // compare fails
setlocale(LC_ALL,"");
printf("\n%d",_wcsicmp(L"ä", L"Ä")); // compare succeeds
}
代わりに _create_locale、_wcreate_locale を呼び出し、_wcsicmp_lへのパラメーターとして返されるロケール オブジェクトを渡すことです。
これらの関数はすべて、パラメーターを検証します。string1 か string2 が NULL のポインターである場合、無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように、開始されます。実行の継続が許可された場合、これらの関数は _NLSCMPERROR を返し、errno を EINVAL に設定します。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tcsicmp |
_stricmp |
_mbsicmp |
_wcsicmp |
必要条件
ルーチン |
必須ヘッダー |
---|---|
_stricmp, _stricmp_l |
<string.h> |
_wcsicmp, _wcsicmp_l |
<string.h> または <wchar.h> |
_mbsicmp, _mbsicmp_l |
<mbstring.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_stricmp.c
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
char string1[] = "The quick brown dog jumps over the lazy fox";
char string2[] = "The QUICK brown dog jumps over the lazy fox";
int main( void )
{
char tmp[20];
int result;
// Case sensitive
printf( "Compare strings:\n %s\n %s\n\n", string1, string2 );
result = strcmp( string1, string2 );
if( result > 0 )
strcpy_s( tmp, _countof(tmp), "greater than" );
else if( result < 0 )
strcpy_s( tmp, _countof(tmp), "less than" );
else
strcpy_s( tmp, _countof(tmp), "equal to" );
printf( " strcmp: String 1 is %s string 2\n", tmp );
// Case insensitive (could use equivalent _stricmp)
result = _stricmp( string1, string2 );
if( result > 0 )
strcpy_s( tmp, _countof(tmp), "greater than" );
else if( result < 0 )
strcpy_s( tmp, _countof(tmp), "less than" );
else
strcpy_s( tmp, _countof(tmp), "equal to" );
printf( " _stricmp: String 1 is %s string 2\n", tmp );
}
同等の .NET Framework 関数
参照
関連項目
strncmp、wcsncmp、_mbsncmp、_mbsncmp_l
_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l
strrchr、wcsrchr、_mbsrchr、_mbsrchr_l