_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Artikel
02/26/2013

Vergleicht Zeichenfolgen mithilfe von gebietsschemaspezifischen Informationen.

Wichtig
_mbsncoll und _mbsncoll_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 _strncoll( const char *string1, const char *string2, size_t count ); int _wcsncoll( const wchar_t *string1, const wchar_t *string2, size_t count ); int _mbsncoll( const unsigned char *string1, const unsigned char *string2, size_t count ); int _strncoll_l( const char *string1, const char *string2, size_t count, _locale_t locale ); int _wcsncoll_l( const wchar_t *string1, const wchar_t *string2, size_t count, _locale_t locale ); int _mbsncoll_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
Die Anzahl der zu vergleichenden Zeichen.
locale
Das Gebietsschema zu verwenden.

Rückgabewert

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

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

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

Hinweise

Jede dieser Funktionen führt einen Groß-/Kleinschreibung Vergleich der ersten count Zeichen in string1 und in string2, entsprechend der Codepage aus, die derzeit verwendet wird.Verwenden Sie diese Funktionen nur, wenn es einen Unterschied zwischen der Sortierung des - Zeichensatzes und der lexikografischen Reihenfolge in der Codepage gibt und dieser Unterschied relevant für den Zeichenfolgenvergleich ist.Die Sortierung des - Zeichensatzes ist gebietsschemaabhängig.Die Versionen dieser Funktionen, die nicht die _l Suffixverwendung das aktuelle Gebietsschema haben, aber die Versionen, die die _l Suffixverwendung das Gebietsschema haben, 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 oder count 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