strcasecmp() — 大/小文字を区別しないストリングの比較
フォーマット
#include <strings.h>
int srtcasecmp(const char *string1, const char *string2);言語レベル
XPG4
スレッド・セーフ
はい
ロケール依存
この関数の振る舞いは、現行ロケールの LC_CTYPE カテゴリーの影響を受ける可能性があります。この関数は、コンパイル・コマンドに対して LOCALETYPE(*CLD) が指定されている場合には使用できません。詳細については、CCSID およびロケールの理解を参照してください。
説明
strcasecmp() 関数は、 大/小文字を区別せずに string1 と string2 を比較します。 string1 および string2 内のすべての英字は、比較の前に小文字に変換されます。
strcasecmp() 関数は、ヌル終了ストリングを扱います。 関数のストリング引数には、ストリングの終わりを示すマークであるヌル文字 ('¥0') が含まれると想定されます。
戻り値
strcasecmp() 関数は、2 つのストリング間の関係を示す次のような値を戻します。
| 値 | 意味 |
|---|---|
| 0 より小さい値 | string1 は string2 より小さい |
| 0 | string1 は string2 と等しい |
| 0 より大きい値 | string1 は string2 より大きい |
例
この例では、strcasecmp() を使用して、2 つのストリングを比較します。
#include <stdio.h>
#include <strings.h>
int main(void)
{
char_t *str1 = "STRING";
char_t *str2 = "string";
int result;
result = strcasecmp(str1, str2);
if (result == 0)
printf("Strings compared equal.¥n");
else if (result < 0)
printf("¥"%s¥" is less than ¥"%s¥".¥n", str1, str2);
else
printf("¥"%s¥" is greater than ¥"%s¥".¥n", str1, str2);
return 0;
}
/******** The output should be similar to: ***************
Strings compared equal.
***********************************/