Freigeben über


_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

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

Wichtiger HinweisWichtig

_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

TCHAR.H-Routine

_UNICODE & _MBCS nicht definiert.

_MBCS definiert

_UNICODE definiert

_tcsncicmp

_strnicmp

_mbsnicmp

_wcsnicmp

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsncicmp_l

_strnicmp_l

_mbsnicmp_l

_wcsnicmp_l

Anforderungen

Routine

Erforderlicher Header

_strnicmp, _strnicmp_l

<string.h>

_wcsnicmp, _wcsnicmp_l

<string.h> oder <wchar.h>

_mbsnicmp, _mbsnicmp_l

<mbstring.h>

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität.

Beispiel

Im Beispiel für strncmp.

.NET Framework-Entsprechung

System::String::Compare

Siehe auch

Referenz

Zeichenfolgenbearbeitung (CRT)

strcat, wcscat, _mbscat

strcmp, wcscmp, _mbscmp

überprüfte, wcscpy, _mbscpy

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l

strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

strspn, wcsspn, _mbsspn, _mbsspn_l