_mbsnbicmp, _mbsnbicmp_l

Artikel
02/26/2013

Vergleicht n Bytes von zwei Mehrbyte-Zeichenfolgen und Fall ignoriert.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

int _mbsnbicmp( const unsigned char *string1, const unsigned char *string2, size_t count );

Parameter

string1, string2
Auf NULL endende Zeichenfolgen zu vergleichen.
count
Anzahl Bytes zu vergleichen.

Rückgabewert

Der Rückgabewert gibt die Beziehung zwischen den Teilzeichenfolgen an.

Rückgabewert	Beschreibung
< 0	string1 Teilzeichenfolge kleiner als string2 Teilzeichenfolge.
0	string1 Teilzeichenfolge identisch zu string2 Teilzeichenfolge.
> 0	string1 Teilzeichenfolge größer als string2 Teilzeichenfolge.

Auf einem Fehler gibt _mbsnbcmp_NLSCMPERROR zurück, der in String.h und in Mbstring.h definiert ist.

Hinweise

Die _mbsnbicmp-Funktion vergleicht lexikografisch höchstens die ersten count Bytes von string1 und string2.Der Vergleich wird ohne Berücksichtigung Fall ausgeführt; _mbsnbcmp ist eine Groß-/Kleinschreibung Version von _mbsnbicmp.Der Vergleich beendet, wenn ein NULL in jeder Zeichenfolge erreicht wird, bevor count Zeichen verglichen werden.Wenn die Zeichenfolgen gleich sind, wenn ein NULL in jeder Zeichenfolge erreicht wird, bevor count Zeichen verglichen werden, ist die kürzere Zeichenfolge kleiner.

_mbsnbicmp ist zu _mbsnicmp vergleichbar, außer dass vergleicht Zeichenfolgen von Bytes statt durch Zeichen.

Zwei Zeichenfolgen, die die Zeichen befunden werden zwischen "Z" und "a" in der ASCII-Tabelle enthalten ("[", "\", "]", "^", "_" und '"") vergleichen anders, abhängig von ihrem Fall.Beispielsweise vergleichen die beiden Zeichenfolgen "ABCDE" und "ABCD^" eine Möglichkeit, wenn der Vergleich Kleinbuchstaben ("abcde" > "abcd^") und die andere Methode ist ("ABCDE" < "ABCD^") wenn sie ein Großbuchstabe ist.

_mbsnbicmp erkennt Mehrbytezeichensequenzen entsprechend Mehrbyte-Codepage derzeit.Es wird nicht durch die aktuelle Gebietsschemaeinstellung beeinflusst.

Wenn entweder string1 oder string2 ein NULL-Zeiger ist, ruft _mbsnbicmp den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, gibt die Funktion _NLSCMPERROR zurück und legt errno zu EINVAL fest.

Zuordnung generische Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tcsnicmp	_strnicmp	_mbsnbicmp	_wcsnicmp
_tcsnicmp_l	_strnicmp_l	_mbsnbicmp_l	_wcsnicmp_l

Anforderungen

Routine	Erforderlicher Header
_mbsnbicmp	<mbstring.h>

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

Im Beispiel für _mbsnbcmp, _mbsnbcmp_l.

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufzurufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.