_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