_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

Vergleicht Zeichenfolgen mithilfe gebietsschemaspezifischen Informationen.

Wichtig

_mbsicoll und _mbsicoll_l können nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

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
Zu vergleichende mit NULL endende Zeichenfolgen.

locale
Das zu verwendende Gebietsschema.

Rückgabewert

Jede dieser Funktionen gibt einen Wert zurück, der die Beziehung von string1 "zu string2" wie folgt angibt.

Rückgabewert	Beziehung von string1 zu string2
< 0	string1 kleiner als string2
0	string1 identisch mit string2
> 0	string1 größer als string2
_NLSCMPERROR	Ein Fehler ist aufgetreten.

Jede dieser Funktion gibt _NLSCMPERROR zurück. Schließen Sie zum Verwenden _NLSCMPERRORentweder <string.h> oder <mbstring.h> ein. _wcsicoll kann fehlschlagen, wenn string1 oder string2 NULL ist oder Codes mit Breitzeichen außerhalb der Domäne der Sortierreihenfolge enthält. Wenn ein Fehler auftritt, legt _wcsicollerrno möglicherweise auf EINVAL fest. Um einen Aufruf von _wcsicoll auf einen Fehler zu überprüfen, legen Sie errno auf 0 fest, und überprüfen Sie dann errno, nachdem Sie _wcsicoll aufgerufen haben.

Hinweise

Jede dieser Funktionen vergleicht string1 und string2 ohne Beachtung der Groß-/Kleinschreibung entsprechend der derzeit verwendeten Codepage. Diese Funktionen sollten nur verwendet werden, wenn es einen Unterschied zwischen der Zeichensatzreihenfolge und der lexikografischen Zeichenreihenfolge auf der aktuellen Codeseite gibt und dieser Unterschied für den Zeichenfolgenvergleich von Interesse ist.

_stricmp unterscheidet sich dadurch von _stricoll, dass der _stricmp-Vergleich von LC_CTYPE beeinflusst wird, während der _stricoll-Vergleich den LC_CTYPE- und LC_COLLATE-Kategorien des Gebietsschemas entspricht. Weitere Informationen zur LC_COLLATE Kategorie finden Sie unter setlocale den Gebietsschemakategorien. Die Versionen dieser Funktionen ohne das _l-Suffix verwenden das aktuelle Gebietsschema. Die Versionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch stattdessen das ihnen übergebene Gebietsschema. Weitere Informationen finden Sie unter Locale.

Mit allen diesen Funktionen werden ihre Parameter überprüft. Wenn es sich um string1 Zeiger handelt, string2NULL wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen _NLSCMPERROR zurück und stellen errno auf EINVAL ein.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

TCHAR.H-Routine	_UNICODE und _MBCS nicht definiert	_MBCS Definiert	_UNICODE Definiert
_tcsicoll	_stricoll	_mbsicoll	_wcsicoll

Anforderungen

Routine	Erforderlicher Header
_stricoll, _stricoll_l	<string.h>
_wcsicoll, _wcsicoll_l	<wchar.h>, <string.h>
_mbsicoll, _mbsicoll_l	<mbstring.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Gebietsschema
Zeichenfolgenmanipulation
strcoll-Funktionen
localeconv
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l
setlocale, _wsetlocale
strcmp, wcscmp, _mbscmp
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l