_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

Artikel
02/26/2013

Vergleichen von Zeichenfolgen mithilfe der gebietsschemaspezifischen Informationen.

Wichtig
_mbsicoll und _mbsicoll_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 _stricoll( const char *string1, const char *string2 ); int _wcsicoll( const wchar_t *string1, const wchar_t *string2 ); int _mbsicoll( const unsigned char *string1, const unsigned char *string2 ); int _stricoll_l( const char *string1, const char *string2, _locale_t locale ); int _wcsicoll_l( const wchar_t *string1, const wchar_t *string2, _locale_t locale ); int _mbsicoll_l( const unsigned char *string1, const unsigned char *string2, _locale_t locale );

Parameter

string1, string2
Auf NULL endende Zeichenfolgen zu vergleichen.
locale
Das Gebietsschema zu verwenden.

Rückgabewert

Jede dieser Funktionen gibt einen Wert zurück, der das Verhältnis von string1 zu 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
_NLSCMPERROR	Es ist ein Fehler aufgetreten.

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

Hinweise

Jede dieser Funktionen führt ein Vergleich, bei dem nicht zwischen Groß- und Kleinschreibung unterschieden wird, von string1 und von string2 entsprechend der Codepage derzeit aus.Diese Funktionen sollten nur verwendet werden, wenn es einen Unterschied zwischen der Sortierung des - Zeichensatzes gibt und der lexikografischen Reihenfolge in der aktuellen Codepage und diesem Unterschied relevant für den Zeichenfolgenvergleich ist.

_stricmp unterscheidet sich von _stricoll darin, dass der _stricmp Vergleich von LC_CTYPE beeinflusst wird, während der _stricoll Vergleich gemäß den LC_CTYPE und LC_COLLATE Kategorien des Gebietsschemas ist.Weitere Informationen über die LC_COLLATE Kategorie, finden Sie unter setlocale und Gebietsschema-Kategorien.Die Versionen dieser Funktionen ohne das _l Suffix verwenden das aktuelle Gebietsschema; 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 string2NULL Zeiger sind, 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