_mbsnbcmp
, _mbsnbcmp_l
2 つのマルチバイト文字の文字列の先頭の n バイトを比較します。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
int _mbsnbcmp(
const unsigned char *string1,
const unsigned char *string2,
size_t count
);
int _mbsnbcmp_l(
const unsigned char *string1,
const unsigned char *string2,
size_t count,
_locale_t locale
);
パラメーター
string1
, string2
比較対象の文字列。
count
比較するバイト数。
locale
使用するロケール。
戻り値
戻り値は、string1
と string2
の部分文字列間の序数に基づく関係を示しています。
戻り値 | 説明 |
---|---|
< 0 | string1 の部分文字列が string2 の部分文字列より小さい。 |
0 | string1 の部分文字列が string2 の部分文字列と同じ。 |
> 0 | string1 の部分文字列が string2 の部分文字列より大きい。 |
パラメーターの検証エラーが発生し_mbsnbcmp_l
、 _mbsnbcmp
string.h および <mbstring.h>> で<定義されている戻り_NLSCMPERROR
値。
解説
_mbsnbcmp
関数は、count
と string1
の先頭の最大 string2
バイトを比較し、部分文字列の間の関係を示す値を返します。 _mbsnbcmp
は _mbsnbicmp
の大文字と小文字を区別するバージョンです。 とは異なり _mbsnbcoll
、 _mbsnbcmp
ロケールの照合順序の影響を受けません。 _mbsnbcmp
は、現在のマルチバイト コード ページに基づいて、マルチバイト文字のシーケンスを認識します。
_mbsnbcmp
は _mbsncmp
と類似していますが、_mbsncmp
はバイトではなく文字で文字列を比較する点が異なります。
出力値はロケールの LC_CTYPE
カテゴリの設定に影響を受けます。この設定は、マルチバイト文字の先頭および末尾のバイトを指定します。 詳細については、setlocale
を参照してください。 _mbsnbcmp
は、ロケールに依存するこの動作に現在のロケールを使用します。 _mbsnbcmp_l
関数は、代わりに locale
パラメーターを使用することを除けば、同一です。 詳細については、「 Locale」を参照してください。
null ポインターのstring2
string1
場合は、「パラメーターの検証」で説明されているように、これらの関数は無効なパラメーター ハンドラーを呼び出します。 実行の続行が許可されている場合、関数は 、を返 _NLSCMPERROR
し、 errno
次に EINVAL
設定されます。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
---|---|---|---|
_tcsncmp |
strncmp |
_mbsnbcmp |
wcsncmp |
_tcsncmp_l |
strncmp |
_mbsnbcml |
wcsncmp |
必要条件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
_mbsnbcmp |
<mbstring.h> |
_mbsnbcmp_l |
<mbstring.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// crt_mbsnbcmp.c
#include <mbstring.h>
#include <stdio.h>
char string1[] = "The quick brown dog jumps over the lazy fox";
char string2[] = "The QUICK brown fox jumps over the lazy dog";
int main( void )
{
char tmp[20];
int result;
printf( "Compare strings:\n %s\n", string1 );
printf( " %s\n\n", string2 );
printf( "Function: _mbsnbcmp (first 10 characters only)\n" );
result = _mbsncmp( string1, string2 , 10 );
if( result > 0 )
_mbscpy_s( tmp, sizeof(tmp), "greater than" );
else if( result < 0 )
_mbscpy_s( tmp, sizeof(tmp), "less than" );
else
_mbscpy_s( tmp, sizeof(tmp), "equal to" );
printf( "Result: String 1 is %s string 2\n\n", tmp );
printf( "Function: _mbsnicmp _mbsnicmp (first 10 characters only)\n" );
result = _mbsnicmp( string1, string2, 10 );
if( result > 0 )
_mbscpy_s( tmp, sizeof(tmp), "greater than" );
else if( result < 0 )
_mbscpy_s( tmp, sizeof(tmp), "less than" );
else
_mbscpy_s( tmp, sizeof(tmp), "equal to" );
printf( "Result: String 1 is %s string 2\n\n", tmp );
}
出力
Compare strings:
The quick brown dog jumps over the lazy fox
The QUICK brown fox jumps over the lazy dog
Function: _mbsnbcmp (first 10 characters only)
Result: String 1 is greater than string 2
Function: _mbsnicmp _mbsnicmp (first 10 characters only)
Result: String 1 is equal to string 2
関連項目
文字列操作
_mbsnbcat
, _mbsnbcat_l
_mbsnbicmp
, _mbsnbicmp_l
strncmp
, wcsncmp
, _mbsncmp
, _mbsncmp_l
_strnicmp
, _wcsnicmp
, _mbsnicmp
, _strnicmp_l
, _wcsnicmp_l
, _mbsnicmp_l
ロケール
マルチバイト文字シーケンスの解釈
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示