Provided by:
manpages-pt-dev_20040726-4_all 
NOME
wcrtomb - converte um caractere largo para uma sequencia multibyte
SINOPSE
#include <wchar.h>
size_t wcrtomb (char *s, wchar_t wc, mbstate_t *ps);
DESCRI,C~AO
O principal caso para esta funcao e quando s e nao NULL e wc nao e
L'\0'. Nesse caso, a funcao wcrtomb converte o caractere largo wc para
sua representacao multibyte e armazena-o no inicio do vetor de
caracteres apontado por s. Atualiza o indicador de deslocamento *ps, e
retorna o tamanho da representacao em multibyte, isto e, o numero de
bytes escritos em s.
Um caso diferente e quando s e nao NULL mas wc e L'\0'. Nesse caso a
funcao wcrtomb armazena no vetor de caracteres apontado por s a
sequencia de deslocamento necessaria para trazer *ps de volta ao seu
estado inicial, seguida por um byte '\0'. Atualiza o indicador de de
estado *ps (i.e. leva-o ao estado inicial), e retorna o tamanho da
sequencia de deslocamento mais um, i.e. o numero de bytes escritos em
s.
O terceiro caso e quando s e NULL. Nesse caso wc e ignorado, e a funcao
efetivamente retorna wcrtomb(buf,L'\0',ps) onde buf e um buffer interno
anonimo.
Em todos os casos acima, se ps e um ponteiro NULL, o estado anonimo
estatico somente da a conhecer para a funcao wcrtomb e usada em seu
lugar.
VALOR DE RETORNO
A funcao wcrtomb retorna o numero de bytes que foram ou deveriam ter
sido escritos para o vetor de byte s. Se wc nao puder ser representado
como uma sequencia multibyte (de acordo com o locale corrente),
(size_t)(-1) e retornado, e errno e atualizado para EILSEQ.
CONFORMIDADE
ISO/ANSI C, UNIX98
VEJA TAMB'EM
wcsrtombs(3)
NOTAS
O comportamento de wcrtomb depende da categoria LC_CTYPE do locale
corrente.
A passagem de NULL como ps nao e segura para multi-thread.
TRADUZIDO POR LDP-BR em 25/08/2000
Marcelo D. Beckmann <marcelobeckmann@yahoo.com> (traducao) Espaco para
o Revisor <nome@dominio.com.br> (revisao)