_mbsbtype, _mbsbtype_l
Devuelve el tipo de bytes en una cadena.
.gif "Nota importante") Importante |
|---|
Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /ZW. |
int _mbsbtype(
const unsigned char *mbstr,
size_t count
);
int _mbsbtype_l(
const unsigned char *mbstr,
size_t count,
_locale_t locale
);
Parámetros
mbstr
Dirección de una secuencia de caracteres multibyte.count
Desplazamiento de bytes del encabezado de la cadena.locale
Configuración regional a utilizar.
Valor devuelto
_mbsbtype y _mbsbtype_l devuelve un valor entero que indica el resultado de pruebas en el byte especificado.Las constantes evidentes en la tabla siguiente se definen en Mbctype.h.
Valor devuelto |
Tipo de byte |
|---|---|
_MBC_SINGLE (0) |
Carácter de Solo- byte.Por ejemplo, en la página de códigos 932, _mbsbtype devuelve 0 si el byte especificado está dentro del intervalo 0x20 – 0x7E o 0xA1 – 0xDF. |
_MBC_LEAD (1) |
Byte inicial de caracteres multibyte.Por ejemplo, en la página de códigos 932, _mbsbtype devuelve 1 si el byte especificado está dentro del intervalo 0x81 – 0x9F o 0xE0 – 0xFC. |
_MBC_TRAIL (2) |
Byte final de caracteres multibyte.Por ejemplo, en la página de códigos 932, _mbsbtype devuelve 2 si el byte especificado está dentro del intervalo 0x40 – 0x7E o 0x80 – 0xFC. |
_MBC_ILLEGAL (–1) |
cadena de NULL, carácter no válido, o byte de NULL hallado antes de bytes en count de desplazamiento en mbstr. |
Comentarios
La función de _mbsbtype determina el tipo de un byte en una cadena de caracteres multibyte.La función solo examina el byte de count de desplazamiento en mbstr, omitiendo caracteres no válidos antes de byte especificado.
El valor de salida se ve afectado por el valor de la categoría de LC_CTYPE de configuración regional; vea setlocale para obtener más información.La versión de esta función sin el sufijo de _l utiliza la configuración regional actual para este comportamiento configuración regional-dependiente; la versión con el sufijo de _l es idéntica excepto que uso que el parámetro locale pasó en su lugar.Para obtener más información, vea Configuración regional.
Si la cadena de entrada es NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, errno se establece en EINVAL y la función devuelve _MBC_ILLEGAL.
Requisitos
Rutina |
Encabezado necesario |
Encabezado opcional |
|---|---|---|
_mbsbtype |
<mbstring.h> |
<mbctype.h>* |
_mbsbtype_l |
<mbstring.h> |
<mbctype.h>* |
* Para las constantes de manifiesto utilizados como valores devueltos.
Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.
Equivalente en .NET Framework
No aplicable, pero vea System::Globalization::CultureInfo.