(0) exportieren Drucken
Alle erweitern
CAB
Uhr
EOF
Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

Vergleicht n Bytes von zwei Mehrbyte-Zeichenfolgen mithilfe der Mehrbyte-Codepage-Informationen.

Wichtiger Hinweis Wichtig

Dieses API kann nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

int _mbsnbcoll( const unsigned char *string1, const unsigned char *string2, size_t count ); int _mbsnbcoll_l( const unsigned char *string1, const unsigned char *string2, size_t count, _locale_t locale ); int _mbsnbicoll( const unsigned char *string1, const unsigned char *string2, size_t count ); int _mbsnbicoll_l( const unsigned char *string1, const unsigned char *string2, size_t count, _locale_t locale );

string1, string2

Die zu vergleichenden Zeichenfolgen.

count

Die Anzahl der zu vergleichenden Bytes.

locale

Das zu verwendende Gebietsschema.

Der Rückgabewert gibt die Beziehung der Teilzeichenfolgen in string1 und von string2 an.

Rückgabewert

Beschreibung

< 0

Teilzeichenfolge string1 ist kleiner als Teilzeichenfolge string2.

0

Teilzeichenfolge string1 ist identisch zu Teilzeichenfolge string2 .

> 0

Teilzeichenfolge string1 ist größer als Teilzeichenfolge string2.

Wenn string1 oder string2NULL 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. Um _NLSCMPERROR zu verwenden, inkludieren Sie entweder String.h oder Mbstring.h.

Jede dieser Funktionen sortiert höchstens die ersten count Bytes in string1 und in string2 und gibt einen Wert, der die Beziehung zwischen den resultierenden Teilzeichenfolgen in string1 und string2 angibt. Wenn das endgültige Byte der Teilzeichenfolge von string1 oder von string2 ein führendes Byte ist, wird es nicht im Vergleich enthalten; diese Funktionen vergleichen nur vollständige Zeichen in den Teilzeichenfolgen. _mbsnbicoll ist eine Version von _mbsnbcoll, die die Groß/Kleinschreibung berücksichtigt. Wie _mbsnbcmp und _mbsnbicmp sortieren _mbsnbcoll und _mbsnbicoll die zwei Mehrbyte-Zeichenfolgen entsprechend der lexikografischen Reihenfolge lediglich, in die Verwendung von - Codepage angegeben wird.

Bei einigen Codepages und den zugehörigen Zeichensätze kann die Reihenfolge der Zeichen im Zeichensatz von der lexikografischen Reihenfolge abweichen. Im "C"-Gebietsschema ist dies nicht der Fall: die Reihenfolge der Zeichen im ASCII-Zeichensatz entspricht der lexikografische Reihenfolge der Zeichen. In bestimmten europäischen Codepages beispielsweise das Zeichen "a" (Wert 0x61) wird dem Zeichen "ä" (Wert 0xE4) im Zeichensatz, dem Zeichen "ä" vor dem Zeichen "a" lexikografisch voran. Um einen lexikografischen Vergleich von Zeichenfolgen von Bytes in einer solchen Instanz auszuführen, verwenden Sie _mbsnbcoll statt _mbsnbcmp; um nur für Zeichenfolgengleichheit zu überprüfen, verwenden Sie _mbsnbcmp.

Da die coll-Funktionen Zeichenfolgen lexikografisch für Vergleich sortieren, während der Test cmp-Funktionen einfach für Zeichenfolgengleichheit, die coll-Funktionen viel langsamer als die entsprechenden cmp-Versionen sind. Daher, sollten die coll-Funktionen 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 Vergleich ist.

Der Ausgabewert wird durch die LC_CTYPE Kategorie des Gebietsschemas beeinflusst; Bei der Funktion setlocale finden Sie weitere Informationen. Die Versionen dieser Funktionen ohne _l Suffix verwenden für ihr gebietsschemaabhängiges Verhalten das aktuelle Gebietsschema; die Versionen mit Suffix _l sind identisch, allerdings verwenden den übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Gebietsschema.

Zuordnung generische Textroutinen

Tchar.h-Routine

_UNICODE und _MBCS undefiniert

_MBCS definiert

_UNICODE definiert

_tcsncoll

_strncoll

_mbsnbcoll

_wcsncoll

_tcsncoll_l

_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

_mbsnbcoll_l

_wcsncoll_l

_tcsnicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll_l

_strnicoll_l

_mbsnbicoll_l

_wcsnicoll_l

Routine

Erforderlicher Header

_mbsnbcoll

<mbstring.h>

_mbsnbcoll_l

<mbstring.h>

_mbsnbicoll

<mbstring.h>

_mbsnbicoll_l

<mbstring.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft