Función de biblioteca C - mbstowcs ()

Descripción

La función de la biblioteca C size_t mbstowcs(schar_t *pwcs, const char *str, size_t n) convierte la cadena de caracteres multibyte a la que apunta, por el argumento str a la matriz apuntada por pwcs.

Declaración

A continuación se muestra la declaración de la función mbstowcs ().

size_t mbstowcs(schar_t *pwcs, const char *str, size_t n)

Parámetros

pwcs - Este es el puntero a una matriz de elementos wchar_t que es lo suficientemente larga para almacenar una cadena ancha con un máximo de caracteres.
str - Ésta es la cadena de caracteres de varios bytes en C que se va a interpretar.
n - Este es el número máximo de caracteres wchar_t a interpretar.

Valor devuelto

Esta función devuelve el número de caracteres traducidos, excluyendo el carácter nulo final. Si se encuentra un carácter multibyte no válido, se devuelve un valor -1.

Ejemplo

El siguiente ejemplo muestra el uso de la función mbstowcs ().

#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("Converting to multibyte string\n");
   len = wcstombs( pmb, pwc, MB_CUR_MAX);
   printf("Characters converted %d\n", len);
   printf("Hex value of first multibyte character: %#.4x\n", pmb);
   
   printf("Converting back to Wide-Character string\n");
   len = mbstowcs( pwcs, pmb, MB_CUR_MAX);
   printf("Characters converted %d\n", len);
   printf("Hex value of first wide character %#.4x\n\n", pwcs);
   
   return(0);
}

Compilemos y ejecutemos el programa anterior que producirá el siguiente resultado:

Converting to multibyte string
Characters converted 1
Hex value of first multibyte character: 0x19a60010
Converting back to Wide-Character string
Characters converted 1
Hex value of first wide character 0x19a60030

↰ Previous page