Freigeben über


_mbsbtype, _mbsbtype_l

Gibt den Typ des Bytes innerhalb einer Zeichenfolge zurück.

Wichtiger HinweisWichtig

Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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 Mehrbytezeichen.

  • count
    Byteoffset vom Anfang der Zeichenfolge.

  • locale
    Zu verwendende Gebietsschema.

Rückgabewert

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

Rückgabewert

Bytetyp

_MBC_SINGLE (0)

Einzelbytezeichen.Beispielsweise der Codepage 932, _mbsbtype gibt 0 zurück, wenn das angegebene Byte innerhalb des Bereichs 0x20 - 0x7E oder 0xA1 - 0xDF ist.

_MBC_LEAD (1)

Führendes Byte Mehrbytezeichen.Beispielsweise der Codepage 932, _mbsbtype gibt 1 zurück, wenn das angegebene Byte innerhalb des Bereichs von - F oder 0xE0 - 0xFC ist.

_MBC_TRAIL (2)

Nachfolgendes Byte Mehrbytezeichen.Beispielsweise der Codepage 932, _mbsbtype gibt 2 zurück, wenn das angegebene Byte innerhalb des Bereichs 0x40 - 0x7E oder 0x80 - 0xFC ist.

_MBC_ILLEGAL (–1)

NULL Zeichenfolge, ungültiges Zeichen oder NULL Byte gefunden vor dem Byte bei Offset-count in mbstr.

Hinweise

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

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; setlocale finden Sie weitere Informationen.Die Version dieser Funktion ohne das _l Suffix verwendet das aktuelle Gebietsschema für dieses Verhalten abhängig; die Version mit dem _l Suffix ist identisch, außer dass verwendet, die in der Gebietsschemaparameter stattdessen übergeben.Weitere Informationen finden Sie unter Gebietsschema.

Wenn die Eingabezeichenfolge NULL ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EINVAL festgelegt und die Funktion gibt _MBC_ILLEGAL zurück.

Anforderungen

Routine

Erforderlicher Header

Optionaler Header

_mbsbtype

<mbstring.h>

<mbctype.h>*

_mbsbtype_l

<mbstring.h>

<mbctype.h>*

Für die * Manifesten Konstanten verwendet als Rückgabewerte.

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

.NET Framework-Entsprechung

Nicht zutreffend, aber finden Sie unter System::Globalization::CultureInfo.

Siehe auch

Referenz

Byte-Klassifizierung