WCTOMB(3)

NOME
wctomb - converte um caractere largo para uma seqüência multibyte

SINÓPSE
#include <stdlib.h>

int wctomb (char *s, wchar_t wc);

DESCRIÇÃO
Se s não é NULO, a função wctomb converte o caracatere largo wc para sua representação multibyte e a armazena no início do array de caracteres apontado por s. Ele atualiza o estado de transição, o qual é armazenado numa variável static anônima conhecida apenas para a função wctomb, e retorna o tamanho da representação multibyte citada, ou seja, o número de bytes escritos em s.

O programador deve garantir que há espaço para pelo menos MB_CUR_MAX bytes em s.

Se s é NULO, a função wctomb reinicializa o estado de transição, conhecido apenas para esta função, para o estado inicial, e retorna não zero se a codificação possui um estado de transição não trivial, ou zero se a codificação não tem estado.

VALORES RETORNADOS
Se s não é NULO, a função wctomb retorna o número de bytes que foram escritos para o array de bytes em s. Se wc não pode ser representado como uma seqüência multibyte (de acordo com o locale atual), -1 é retornado.

Se s é NULO, a função wctomb retorna não zero se a codificação possui um estado de transição não trivial, ou zero se a codificação não tem estado.

DE ACORDO COM
ISO/ANSI C, UNIX98.

VEJA TAMBÉM
wcrtomb(3), wcstombs(3), MB_CUR_MAX(3).

NOTAS
O comportamento de wctomb depende da categoria LC_CTYPE da localização atual.

Esta função não é segura para multi-thread. A função wcrtomb fornece uma interface melhor para a mesma funcionalidade.

TRADUZIDO POR LDP-BR em 16/03/2001.

  Tradução:
Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>