Compartir a través de

_mbbtype, _mbbtype_l

  • Artículo

Devuelve el tipo de bytes, según el byte anterior.

Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas en aplicaciones de la Plataforma universal de Windows.

Sintaxis

int _mbbtype(
   unsigned char c,
   int type
);
int _mbbtype_l(
   unsigned char c,
   int type,
   _locale_t locale
);

Parámetros

c
Carácter que se va a probar.

type
El tipo de byte que se va a probar.

locale
Configuración regional que se va a usar.

Valor devuelto

_mbbtypedevuelve el tipo de byte en una cadena. Esta decisión es contextual, según lo especificado por el valor de type, que proporciona la condición de prueba del control. type es el tipo del byte anterior de la cadena. Las constantes de manifiesto de la siguiente tabla se definen en Mbctype.h.

Valor de type Pruebas _mbbtype para Valor devuelto c
Cualquier valor excepto 1 Byte único o byte inicial válidos _MBC_SINGLE (0) Byte único (0x20 - 0x7E, 0xA1 - 0xDF)
Cualquier valor excepto 1 Byte único o byte inicial válidos _MBC_LEAD (1) Byte inicial de un carácter multibyte (0x81 - 0x9F, 0xE0 - 0xFC)
Cualquier valor excepto 1 Byte único o byte inicial válidos. _MBC_ILLEGAL (-1) Carácter no válido: no un solo cliente potencial (0x00: 0x1F, 0x7F, 0x80, 0xA0, 0xFD, 0xFE, 0xFF)
1 Byte final válido _MBC_TRAIL (2) Byte final de un carácter multibyte (0x40 - 0x7E, 0x80 - 0xFC)
1 Byte final válido _MBC_ILLEGAL (-1) Carácter no válido: no final (0x00: 0x3F, 0x7F, 0xFD, 0xFE, 0xFF)

Comentarios

La función _mbbtype determina el tipo de un byte de un carácter multibyte. Si el valor de type es cualquier valor excepto 1, _mbbtype prueba para un byte único o un byte inicial válidos de un carácter multibyte. Si el valor de type es 1, _mbbtype prueba para un byte final válido de un carácter multibyte.

El valor de salida se ve afectado por el valor de la categoría LC_CTYPE de la configuración regional. Para más información, vea setlocale, _wsetlocale. La _mbbtype versión de esta función usa la configuración regional actual para este comportamiento dependiente de la configuración regional; la _mbbtype_l versión es idéntica, excepto que usa el parámetro de configuración regional que se pasa en su lugar. Para obtener más información, vea Locale.

En versiones anteriores, _mbbtype se denominaba chkctype. Para el código nuevo use _mbbtype.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine Encabezado necesario Encabezado opcional
_mbbtype <mbstring.h> <mbctype.h>*
_mbbtype_l <mbstring.h> <mbctype.h>*

* Para las definiciones de constantes de manifiesto que se usan como valores devueltos.

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Consulte también

Clasificación de bytes