_mbsbtype, _mbsbtype_l

  • Artikel

Gibt den Bytetyp in einer Zeichenfolge zurück.

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 _mbsbtype(
   const unsigned char *mbstr,
   size_t count
);
int _mbsbtype_l(
   const unsigned char *mbstr,
   size_t count,
   _locale_t locale
);

Parameter

mbstr
Adresse einer Sequenz von Multibytezeichen.

count
Byte-Offset vom Anfang der Zeichenfolge.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

_mbsbtype und _mbsbtype_l gibt einen ganzzahligen Wert zurück, der das Ergebnis des Tests auf dem angegebenen Byte angibt. Die Manifestkonstanten in der folgenden Tabelle sind in Mbctype.h definiert.

Rückgabewert Bytetyp
_MBC_SINGLE (0) Einzelbytezeichen. Gibt beispielsweise auf der Codeseite 932 "0" zurück, _mbsbtype wenn sich das angegebene Byte im Bereich 0x20 - 0x7E oder 0xA1 - 0xDF befindet.
_MBC_LEAD (1) Führendes Byte des Multibytezeichens. Gibt beispielsweise auf der Codeseite 932 "1" zurück, _mbsbtype wenn sich das angegebene Byte im Bereich 0x81 - 0x9F oder 0xE0 - 0xFC befindet.
_MBC_TRAIL (2) Nachfolgendes Byte des Multibytezeichens. Gibt beispielsweise auf der Codeseite 932 2 zurück, _mbsbtype wenn sich das angegebene Byte innerhalb des Bereichs 0x40 - 0x7E oder 0x80 - befindet, 0xFC.
_MBC_ILLEGAL (-1) NULL Zeichenfolge, ungültiges Zeichen oder NULL-Byte vor dem Byte beim Offset count in mbstr.

Hinweise

Die _mbsbtype-Funktion bestimmt den Typ eines Bytes in einer Multibyte-Zeichenfolge. Die Funktion überprüft nur das Byte am Offset count in mbstr und ignoriert ungültige Zeichen vor dem angegebenen Byte.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieeinstellung des Gebietsschemas beeinflusst. Weitere Informationen finden Sie unter setlocale. Die Version dieser Funktion ohne das _l-Suffix verwendet das aktuelle Gebietsschema für dieses vom Gebietsschema abhängige Verhalten; die Version mit dem _l-Suffix ist beinahe identisch, verwendet jedoch stattdessen den ihr übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Locale.

Wenn die Eingabezeichenfolge lautet NULL, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL festgelegt, und die Funktion gibt _MBC_ILLEGALbeschrieben.

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
_mbsbtype <mbstring.h> <mbctype.h>*
_mbsbtype_l <mbstring.h> <mbctype.h>*

* Für Manifestkonstanten, die als Rückgabewerte verwendet werden.

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Byteklassifizierung