_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l

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

文字列を小文字を区別しない比較を実行します。

重要
_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 関数

System::String::Compare

次の方法で共有

_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l

パラメーター

戻り値

解説

必要条件

使用例

同等の .NET Framework 関数

参照

関連項目

その他のリソース