_mbbtombc
, _mbbtombc_l
Convierte un carácter multibyte de byte único en el carácter multibyte de doble byte correspondiente.
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
unsigned int _mbbtombc(
unsigned int c
);
unsigned int _mbbtombc_l(
unsigned int c,
_locale_t locale
);
Parámetros
c
Carácter de byte único que se va a convertir.
locale
Configuración regional que se va a usar.
Valor devuelto
Si _mbbtombc
convierte correctamente c
, devuelve un carácter multibyte; de lo contrario, devuelve c
.
Comentarios
La función _mbbtombc
convierte un determinado carácter multibyte de byte único en el carácter multibyte de doble byte correspondiente. Los caracteres deben estar dentro del intervalo 0x20 - 0x7E o 0xA1 - 0xDF para que se efectúe la conversión.
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
. Las versiones de esta función son idénticas, salvo por el hecho de que _mbbtombc
usa la configuración regional actual para este comportamiento dependiente de la configuración regional y _mbbtombc_l
usa el parámetro de configuración regional que se pasa. Para obtener más información, vea Locale.
En versiones anteriores, _mbbtombc
se denominaba hantozen
. Para el código nuevo use _mbbtombc
.
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 |
---|---|
_mbbtombc |
<mbstring.h> |
_mbbtombc_l |
<mbstring.h> |
Para obtener más información sobre compatibilidad, consulte Compatibilidad.