Función de biblioteca C -mbstowcs()

C 标准库 - <stdlib.h>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;
}

Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:

Hello, 世界!

Notas

  1. Locale: El comportamiento de la función se ve afectado por lalocaleconfiguración actual. Normalmente, antes de invocarmbstowcses necesario llamarsetlocalepara establecer la apropiada.locale。
  2. 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.
  3. Asignación de memoria: El llamador debe asegurarse de quepwcshaya 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.

C 标准库 - <stdlib.h>Biblioteca estándar de C - <stdlib.h>

Otras extensiones