Provided by: manpages-pt-dev_20040726-4_all bug

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)