_mbsnbicmp、_mbsnbicmp_l
2 個のマルチバイト文字列の n のバイトを、大文字と小文字を無視して比較します。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。詳細については、「/ZW でサポートされない CRT 関数」を参照してください。
int _mbsnbicmp( const unsigned char *string1, const unsigned char *string2, size_t count );
パラメーター
string1, string2
Null で終わる比較対象の文字列。count
比較するバイト数。
戻り値
戻り値は、部分文字列間の関係を示しています。
戻り値 |
説明 |
|---|---|
< 0 |
string1 の部分文字列が string2 の部分文字列より小さい。 |
0 |
string1 の部分文字列は string2 の部分文字列と同じ。 |
> 0 |
string1 の部分文字列が string2 の部分文字列より大きい。 |
エラーが発生した場合、_mbsnbcmp は _NLSCMPERROR を返します。これは、String.h および Mbstring.h で定義されています。
解説
_mbsnbicmp 関数は、string1 と string2 の先頭の最大 count バイトで序数に基づく比較を実行します。 各文字を小文字に変換することで比較を実行します。_mbsnbcmp は _mbsnbicmp の大文字小文字を区別するバージョンです。 count 文字を比較する前に、どちらかの文字列で終端の NULL 文字に到達すると比較は終了します。 count 文字を比較する前に、どちらかの文字列で終端の NULL 文字に到達したときに、文字列が等しい場合は短いほうの文字列が小さくなります。
_mbsnbicmp は _mbsnicmp に似ていますが、文字ではなく、最大 count バイトの文字列を比較する点が異なります。
ASCII の表の 'Z' と 'a' の間にある文字 ('['、'\'、']'、'^'、'_'、および '`') を含む 2 文字列は、場合に応じて異なる方法で比較します。 たとえば、2 つの文字列 "ABCDE" および "ABCD^" を比較する場合、小文字で比較する場合 ("abcde" > "abcd^") と、大文字で比較する場合 ("ABCDE" < "ABCD^") で方法が異なります。
_mbsnbicmp 関数は、現在使用中のマルチバイト コード ページに基づいて、マルチバイト文字列を認識します。 これは、現在のロケール設定の影響を受けません。
string1 または string2 が null ポインターの場合は、「パラメーターの検証」に説明されているように、_mbsnbicmp は無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、関数は _NLSCMPERROR を返し、errno を EINVAL に設定します。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_tcsnicmp |
_strnicmp |
_mbsnbicmp |
_wcsnicmp |
_tcsnicmp_l |
_strnicmp_l |
_mbsnbicmp_l |
_wcsnicmp_l |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_mbsnbicmp |
<mbstring.h> |
互換性の詳細については、「互換性」を参照してください。
使用例
_mbsnbcmp、_mbsnbcmp_l 関数の例を参照してください。
同等の .NET Framework 関数
該当なし。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。