Función de biblioteca C -mbstowcs()
Biblioteca estándar de C - <stdlib.h>
Descripción
Función de biblioteca CmbstowcsSe utiliza para convertir cadenas de caracteres multibyte a cadenas de caracteres anchos.
mbstowcsLa función está definida en el archivo de cabecera <stdlib.h>.
Declaración
A continuación se muestra la declaración de la función mbstowcs().
size_t mbstowcs(wchar_t *pwcs, const char *mbs, size_t n);
Parámetros
pwcs: Apunta a un búfer utilizado para almacenar la cadena de caracteres anchos convertida. Sipwcses NULL, la función devuelve la longitud del búfer necesaria sin realizar la conversión real.mbs: Puntero a la cadena de caracteres multibyte.n: El número máximo de caracteres a convertir. Si ya se han convertidoncaracteres antes del carácter de terminación, la conversión se detendrá antes de tiempo.
Valor de retorno
- En caso de éxito, devuelve el número de caracteres anchos convertidos, sin incluir el carácter nulo de terminación.
- Si se encuentra una secuencia multibyte no válida, devuelve
(size_t)-1, y estableceerrno。
Ejemplo
El siguiente ejemplo demuestra el uso de la función mbstowcs().
Ejemplo 1
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
int main()
{
int len;
char *pmbnull = NULL;
char *pmb = (char *)malloc( MB_CUR_MAX );
wchar_t *pwc = L"Hi";
wchar_t *pwcs = (wchar_t *)malloc( sizeof( wchar_t ));
printf("Convertir a cadena de caracteres multibyte\n");
len = wcstombs( pmb, pwc, MB_CUR_MAX);
printf("Caracteres convertidos %d\n", len);
printf("Valor hexadecimal del primer carácter multibyte: %#.4x\n", pmb);
printf("Convertir de vuelta a cadena de caracteres anchos\n");
len = mbstowcs( pwcs, pmb, MB_CUR_MAX);
printf("Caracteres convertidos %d\n", len);
printf("Valor hexadecimal del primer carácter ancho: %#.4x\n\n", pwcs);
return(0);
}
Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:
转换为多字节字符串 被转换的字符 1 第一个多字节字符的十六进制值:0x19a60010 转换回宽字符字符串 被转换的字符 1 第一个宽字符的十六进制值:0x19a60030
Ejemplo 2
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>
int main() {
// Establece el locale actual al locale especificado por la variable de entorno del usuario
setlocale(LC_ALL, "");
// Define la cadena de caracteres multibyte
const char *mbstr = ¡Hola, mundo!;
// Calcula el tamaño del búfer necesario
size_t wcs_len = mbstowcs(NULL, mbstr, 0) + 1;
// Asigna el búfer de caracteres anchos
wchar_t *wcs = (wchar_t *)malloc(wcs_len * sizeof(wchar_t));
if (wcs == NULL) {
perror("malloc");
return 1;
}
// Realiza la conversión
mbstowcs(wcs, mbstr, wcs_len);
// Imprime la cadena de caracteres anchos
wprintf(L"%ls\n", wcs);
// Libera la memoria
free(wcs);
return 0;
}
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>
int main() {
// Establece el locale actual al locale especificado por la variable de entorno del usuario
setlocale(LC_ALL, "");
// Define la cadena de caracteres multibyte
const char *mbstr = ¡Hola, mundo!;
// Calcula el tamaño del búfer necesario
size_t wcs_len = mbstowcs(NULL, mbstr, 0) + 1;
// Asigna el búfer de caracteres anchos
wchar_t *wcs = (wchar_t *)malloc(wcs_len * sizeof(wchar_t));
if (wcs == NULL) {
perror("malloc");
return 1;
}
// Realiza la conversión
mbstowcs(wcs, mbstr, wcs_len);
// Imprime la cadena de caracteres anchos
wprintf(L"%ls\n", wcs);
// Libera la memoria
free(wcs);
return 0;
}
Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:
Hello, 世界!
Notas
- Locale: El comportamiento de la función se ve afectado por la
localeconfiguración actual. Normalmente, antes de invocarmbstowcses necesario llamarsetlocalepara establecer la apropiada.locale。 - Manejo de errores: Si la cadena de caracteres multibyte de entrada contiene una secuencia multibyte no válida, la función devuelve
(size_t)-1y estableceerrno. El llamador debe verificar el valor de retorno y manejar posibles errores. - Asignación de memoria: El llamador debe asegurarse de que
pwcshaya suficiente espacio para almacenar la cadena de caracteres anchos convertida. Esto se puede hacer llamando primero ambstowcs, estableciendopwcsaNULLpara calcular el tamaño de búfer requerido.