Função de biblioteca C - mbstowcs ()

Descrição

A função da biblioteca C size_t mbstowcs(schar_t *pwcs, const char *str, size_t n) converte a string de caracteres multibyte apontados pelo argumento str para a matriz apontada por pwcs.

Declaração

A seguir está a declaração para a função mbstowcs ().

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

Parâmetros

pwcs - Este é o ponteiro para uma matriz de elementos wchar_t que é longa o suficiente para armazenar uma string ampla com no máximo caracteres.
str - Esta é a cadeia de caracteres multibyte C a ser interpretada.
n - Este é o número máximo de caracteres wchar_t a serem interpretados.

Valor de retorno

Esta função retorna o número de caracteres traduzidos, excluindo o caractere nulo final. Se um caractere multibyte inválido for encontrado, um valor -1 será retornado.

Exemplo

O exemplo a seguir mostra o uso da função 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);
}

Vamos compilar e executar o programa acima que produzirá o seguinte 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