_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Artikel
02/26/2013

Vergleichen von Zeichenfolgen mithilfe der gebietsschemaspezifischen Informationen.

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

int _strnicoll( const char *string1, const char *string2, size_t count ); int _wcsnicoll( const wchar_t *string1, const wchar_t *string2 , size_t count ); int _mbsnicoll( const unsigned char *string1, const unsigned char *string2, size_t count ); int _strnicoll_l( const char *string1, const char *string2, size_t count, _locale_t locale ); int _wcsnicoll_l( const wchar_t *string1, const wchar_t *string2 , size_t count, _locale_t locale ); int _mbsnicoll_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 zu vergleichen Zeichen
locale
Das Gebietsschema zu verwenden.

Rückgabewert

Jede dieser Funktionen gibt einen Wert zurück, der die Beziehung der Teilzeichenfolgen in string1 und von string2*,* wie folgt angibt.

Rückgabewert	Verhältnis von string1 zu Zeichenfolge2
< 0	string1 kleiner als string2
0	string1 identisch zu string2
> 0	string1 größer als string2

Jede dieser Funktion _NLSCMPERROR.Um _NLSCMPERROR zu verwenden, geben Sie entweder STRING.H oder MBSTRING.H. ein._wcsnicoll kann fehlschlagen, wenn entweder string1 oder string2 Zeichenkodes außerhalb der Domäne der Sortierreihenfolge enthält.Wenn ein Fehler auftritt, wird möglicherweise _wcsnicollerrno zu EINVAL fest.Um für einen Fehler bei einem Aufruf _wcsnicoll sicherzustellen, legen Sie errno auf 0 und überprüfen Sie dann errno nachdem Sie _wcsnicoll**.** aufgerufen haben

Hinweise

Jede dieser Funktionen führt ein Vergleich, bei dem nicht zwischen Groß- und Kleinschreibung unterschieden wird, der ersten count Zeichen in string1 und in string2 entsprechend der Codepage aus.Diese Funktionen sollten nur verwendet werden, wenn es einen Unterschied zwischen der Sortierung des - Zeichensatzes gibt und der lexikografischen Reihenfolge in der Codepage und diesem Unterschied relevant für den Zeichenfolgenvergleich ist.Die Versionen dieser Funktionen ohne das _l Suffix verwenden das aktuelle Gebietsschema und die Codepage.Die Versionen mit dem _l Suffix sind identisch, allerdings verwenden das Gebietsschema, das in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Alle diese Funktionen überprüfen ihre Parameter.Wenn entweder string1 oder string2 ein NULL-Zeiger ist oder wenn Anzahl größer als INT_MAX 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