_ismbslead
, , _ismbstrail
_ismbslead_l
_ismbstrail_l
Führt kontextbezogene Tests für führende und nachfolgende Bytes mit Multibyte-Zechenfolgen aus und bestimmt, ob ein angegebener Teilzeichenfolgenzeiger auf ein führendes Byte oder ein nachfolgendes Byte zeigt.
Wichtig
Diese API kann 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 _ismbslead(
const unsigned char *str,
const unsigned char *current
);
int _ismbstrail(
const unsigned char *str,
const unsigned char *current
);
int _ismbslead_l(
const unsigned char *str,
const unsigned char *current,
_locale_t locale
);
int _ismbstrail_l(
const unsigned char *str,
const unsigned char *current,
_locale_t locale
);
Parameter
str
Zeiger auf den Beginn der Zeichenfolge oder des vorherigen führenden Bytes.
current
Zeiger auf die zu testende Zeichenfolgenposition.
locale
Das zu verwendende Gebietsschema.
Rückgabewert
_ismbslead
gibt -1 zurück, wenn das Zeichen ein Leadbyte ist, und _ismbstrail
gibt -1 zurück, wenn das Zeichen ein Trailbyte ist. Wenn die Eingabezeichenfolgen gültig sind, aber kein Leadbyte oder Trailbyte sind, geben diese Funktionen null zurück. Wenn eines der Argumente lautet NULL
, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen NULL
zurück und stellen errno
auf EINVAL
ein.
Hinweise
_ismbslead
und _ismbstrail
sind langsamer als die _ismbblead
- und _ismbbtrail
-Versionen, da sie den Zeichenfolgenkontext berücksichtigen.
Die Versionen dieser Funktionen mit dem _l
-Suffix sind nahezu identisch, außer dass diejenigen mit dem Suffix anstelle des aktuellen Gebietsschemas das ihnen übergebene Gebietsschema für ihr vom Gebietsschema abhängiges Verhalten verwenden. Weitere Informationen finden Sie unter Locale.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Anforderungen
Routine | Erforderlicher Header | Optionaler Header |
---|---|---|
_ismbslead |
<mbctype.h> oder <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
_ismbstrail |
<mbctype.h> oder <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
_ismbslead_l |
<mbctype.h> oder <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
_ismbstrail_l |
<mbctype.h> oder <mbstring.h> | <ctype.h>,* <limits.h>, <stdlib.h> |
* Für Manifestkonstanten für die Testbedingungen.
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Siehe auch
Zeichenklassifizierung
_ismbc
Routinen
is
, isw
-Routinen
_ismbb
Routinen