_ismbclegal
, , _ismbclegal_l
_ismbcsymbol
_ismbcsymbol_l
Überprüft, ob ein Multibytezeichen ein gültiges Zeichen oder ein Symbolzeichen ist.
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 _ismbclegal(
unsigned int c
);
int _ismbclegal_l(
unsigned int c,
_locale_t locale
);
int _ismbcsymbol(
unsigned int c
);
int _ismbcsymbol_l(
unsigned int c,
_locale_t locale
);
Parameter
c
Zu testende Zeichen.
locale
Zu verwendendes Gebietsschema.
Rückgabewert
Jede dieser Routinen gibt einen Wert ungleich Null zurück, wenn das Zeichen die Testbedingung erfüllt. Andernfalls wird "0" zurückgegeben. Wenn c
<= 255 und eine entsprechende _ismbb
Routine vorhanden ist (z _ismbcalnum
. B. entspricht _ismbbalnum
), ist das Ergebnis der Rückgabewert der entsprechenden _ismbb
Routine.
Hinweise
Jede dieser Funktionen testet ein angegebenes Mehrbytezeichen auf eine angegebene Bedingung.
Die Versionen dieser Funktionen mit dem _l
-Suffix sind beinahe identisch, verwenden jedoch das ihnen übergebene Gebietsschema anstelle des aktuellen Gebietsschemas für ihr vom Gebietsschema abhängiges Verhalten. Weitere Informationen finden Sie unter Locale.
Routine | Testbedingung | Beispiel für Codepage 932 |
---|---|---|
_ismbclegal |
Gültiges Multibyte | Gibt einen Wert ungleich 0 (null) nur dann zurück, wenn das erste Byte von c im Bereich 0x81-0x9F oder 0xE0-0xFC liegt, während das zweite Byte im Bereich 0x40-0x7E oder 0x80-FC liegt. |
_ismbcsymbol |
Multibytesymbol | Gibt "nonzero" zurück, wenn 0x8141<=c <=0x81AC. |
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.
Mapping generischer Textroutinen
Tchar.h-Routine | _UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_istlegal |
Gibt immer "false" zurück | _ismbclegal |
Gibt immer false zurück. |
_istlegal_l |
Gibt immer "false" zurück | _ismbclegal_l |
Gibt immer false zurück. |
Anforderungen
Routine | Erforderlicher Header |
---|---|
_ismbclegal , _ismbclegal_l |
<mbstring.h> |
_ismbcsymbol , _ismbcsymbol_l |
<mbstring.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Siehe auch
Zeichenklassifizierung
_ismbc
Routinen
is
, isw
-Routinen
_ismbb
Routinen