次の方法で共有

_mbsnbcmp、_mbsnbcmp_l

  • [アーティクル]

2 個のマルチバイト文字列の n の先頭バイトを比較します。

重要 : 重要

この API は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW 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 の部分文字列と stringの関係を示しています。

戻り値

説明

< 0

string1 部分文字列は string2 部分文字列未満です。

0

string1 部分文字列は string2 部分文字列と同じものです。

> 0

string1 部分文字列は string2 部分文字列より大きい。

String.h および Mbstring.h で定義されるエラーで、_mbsnbcmp は _NLSCMPERRORを返します。

解説

_mbsnbcmp 関数は、辞書式に、最大で、string1 と string2 の count の先頭バイトと応答の部分文字列間の関係を示す値を比較します。_mbsnbcmp は _mbsnbicmpの大文字と小文字を区別するバージョンです。strcollとは異なり、_mbsnbcmp は、ロケールによる影響を受けません。_mbsnbcmp は、現在のマルチバイト コード ページに従ってマルチバイト文字シーケンスを認識します。

_mbsnbcmp は _mbsncmpに似ていますが、_mbsncmp は、バイトではなく文字して文字列を比較します。

出力値は、LC_CTYPE のロケールのカテゴリの設定によって影響を受ける; 詳細については、[setlocale] を参照してください。_l のサフィックスがないこの関数のバージョンが、このロケールに依存する動作に現在のロケールを使用します; _l のサフィックスが同じであるある点は、代わりに渡されたロケール パラメーターを使用するバージョン。詳細については、「ロケール」を参照してください。

string1 または string2 が null ポインターの場合、この関数は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーを呼び出します。実行の継続が許可された場合、関数はを返し、_NLSCMPERRORerrno は EINVALに設定されます。

汎用テキスト ルーチンのマップ

Tchar.h のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_tcsncmp

strncmp

_mbsnbcmp

wcsncmp

_tcsncmp_l

strncmp

_mbsnbcml

wcsncmp

必要条件

ルーチン

必須ヘッダー

_mbsnbcmp

<mbstring.h>

_mbsnbcmp_l

<mbstring.h>

互換性の詳細については、互換性を参照してください。

使用例

// 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

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

文字列操作 (CRT)

_mbsnbcat、_mbsnbcat_l

_mbsnbicmp、_mbsnbicmp_l

strncmp、wcsncmp、_mbsncmp、_mbsncmp_l

_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l

ロケール

マルチバイト文字のシーケンスの解釈