Uso e exemplo da função da biblioteca C wctomb()

Biblioteca padrão do C - <stdlib.h>

função da biblioteca C int wctomb(char *str, wchar_t wchar) converte o caractere wchar converte para sua representação de múltiplos bytes e armazena em str o início do array de caracteres apontado.

Declaração

A seguir está a declaração da função wctomb().

int wctomb(char *str, wchar_t wchar)

parâmetro

• str -- um ponteiro, que aponta para um array suficiente para armazenar caractere de múltiplos bytes.
• wchar -- do tipo wchar_t de caractere largo.

Retorno

• Se str não for NULL, wctomb() retorna o número de bytes escritos no array de bytes. Se o wchar não puder ser representado por uma sequência de múltiplos bytes, será retornado -1。
• Se str for NULL, wctomb() retorna um valor não nulo se o código de caractere tiver estado de deslocamento, ou zero se o código de caractere for inerte.

Exemplo Online

A seguir, há um exemplo que demonstra o uso da função wctomb().

#include <stdio.h>
#include <stdlib.h>
int main()
{
   int i;
   wchar_t wc = L'a';
   char *pmbnull = NULL;
   char *pmb = (char *)malloc(sizeof( char ));
   printf("Caracteres largos a serem convertidos:\n");
   i = wctomb( pmb, wc );
   printf("Caracteres largos a serem convertidos：睵n", i);
   printf("Caracteres de múltiplos bytes：%.1s\n", pmb);
   printf("Tentativa de conversão de caractere NULL:\n");
   i = wctomb( pmbnull, wc );
   printf("Caracteres largos a serem convertidos：睵n", i);
   /* Nenhum valor será impresso */
   printf("Caracteres de múltiplos bytes：%.1s\n", pmbnull);
   return(0);
}

Vamos compilar e executar o programa acima, o que produzirá o seguinte resultado:

Caracteres de largura de ponteiro a serem convertidos:
Caracteres convertidos:1
Caracteres de múltiplos bytes: a
Tente converter o caractere NULL quando o caractere a ser convertido for NULL:
Caracteres convertidos: 0
Caracteres de múltiplos bytes:

Biblioteca padrão do C - <stdlib.h>