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