_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Vergleichen von Zeichenfolgen mithilfe der gebietsschemaspezifischen Informationen.

Wichtiger HinweisWichtig

_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

TCHAR.H-Routine

_UNICODE & _MBCS nicht definiert.

_MBCS definiert

_UNICODE definiert

_tcsncicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll_l

_strnicoll_l

_mbsnbicoll_l

_wcsnicoll_l

Anforderungen

Routine

Erforderlicher Header

_strnicoll, _strnicoll_l

<string.h>

_wcsnicoll, _wcsnicoll_l

<wchar.h> oder <string.h>

_mbsnicoll, _mbsnicoll_l

<mbstring.h>

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

.NET Framework-Entsprechung

System::String::Compare

Siehe auch

Referenz

Gebietsschema

Zeichenfolgenbearbeitung (CRT)

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