_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Artikel
02/26/2013

Vergleicht Zeichen von zwei Zeichenfolgen ohne Berücksichtigung von Fall.

Wichtig
_mbsnicmp und _mbsnicmp_l können in Anwendungen nicht verwendet werden, die in Windows-Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

int _strnicmp( const char *string1, const char *string2, size_t count ); int _wcsnicmp( const wchar_t *string1, const wchar_t *string2, size_t count ); int _mbsnicmp( const unsigned char *string1, const unsigned char *string2, size_t count ); int _strnicmp_l( const char *string1, const char *string2, size_t count, _locale_t locale ); int _wcsnicmp_l( const wchar_t *string1, const wchar_t *string2, size_t count, _locale_t locale ); int _mbsnicmp_l( const unsigned char *string1, const unsigned char *string2, size_t count, _locale_t locale );

Parameter

string1, string2
Auf NULL endende Zeichenfolgen zu vergleichen.
count
Zahl Zeichen zu vergleichen.
locale
Zu verwendende Gebietsschema.

Rückgabewert

Gibt die Beziehung zwischen den Teilzeichenfolgen, wie folgt an.

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

Auf einem Fehler gibt _mbsnicmp_NLSCMPERROR zurück, der in STRING.H und in MBSTRING.H. definiert ist.

Hinweise

Die _strnicmp-Funktion vergleicht lexikografisch höchstens die ersten count Zeichen aus string1 und string2.Der Vergleich wird ohne Berücksichtigung Fall ausgeführt; _strnicmp ist eine Groß-/Kleinschreibung keine Version von strncmp.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.

Die Zeichen von 91 bis 96 in der ASCII-Tabelle ("[", "\", "]", "^", "_" und '"") werten als kleiner als beliebigen Buchstabenzeichen aus.Diese Reihenfolge entspricht der von stricmp identisch.

_wcsnicmp und _mbsnicmp sind Breitzeich und Mehrbytezeichen-Versionen von _strnicmp.Die Argumente und der Rückgabewert von _wcsnicmp sind Breitzeichen-Zeichenfolgen; die von _mbsnicmp sind Mehrbyte-Zeichenfolgen._mbsnicmp erkennt Mehrbytezeichensequenzen entsprechend der aktuellen Mehrbyte-Codepage und gibt _NLSCMPERROR auf einem Fehler zurück.Weitere Informationen finden Sie unter Codepages.Diese drei Funktionen verhalten sich andernfalls identisch.Diese Funktionen werden von die Gebietsschemaeinstellungs-dversionen auswirkt, die nicht die _l Suffixverwendung das aktuelle Gebietsschema für ihren gebietsschemaabhängiges Verhalten aufweisen; die Versionen, die das _l Suffix stattdessen das Gebietsschema verwendet werden, das übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Alle diese Funktionen überprüfen ihre Parameter.Wenn entweder string1 oder string2 ein NULL-Zeiger ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, geben diese Funktionen _NLSCMPERROR zurück und legen errno auf EINVAL fest.

Zuordnung generische Textroutinen