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ÇÃO

       O  principal  caso para esta função é quando s é não NULL e wc não é L'\0'.  Nesse caso, a
       função wcrtomb converte o caractere largo wc para sua representação multibyte e armazena-o
       no  início  do  vetor  de caracteres apontado por s.  Atualiza o indicador de deslocamento
       *ps, e retorna o tamanho da representação em multibyte, isto é, o número de bytes escritos
       em s.

       Um  caso  diferente  é  quando  s  é  não NULL mas wc é L'\0'. Nesse caso a função wcrtomb
       armazena no vetor de caracteres apontado por s a sequencia de deslocamento necessária 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 número de bytes escritos em s.

       O  terceiro  caso  é  quando  s  é NULL. Nesse caso wc é ignorado, e a função efetivamente
       retorna wcrtomb(buf,L'\0',ps) onde buf é um buffer interno anônimo.

       Em todos os casos acima, se ps é um ponteiro NULL, o estado anônimo estático somente da  a
       conhecer para a função wcrtomb é usada em seu lugar.

VALOR DE RETORNO

       A  função wcrtomb retorna o número de bytes que foram ou deveriam ter sido escritos para o
       vetor de byte s. Se wc não puder ser representado como uma sequencia multibyte (de  acordo
       com o locale corrente), (size_t)(-1) é retornado, e errno é atualizado para EILSEQ.

CONFORMIDADE

       ISO/ANSI C, UNIX98

VEJA TAMBÉM

       wcsrtombs(3)

NOTAS

       O comportamento de wcrtomb depende da categoria LC_CTYPE do locale corrente.

       A passagem de NULL como ps não é segura para multi-thread.

TRADUZIDO POR LDP-BR em 25/08/2000

       Marcelo   D.   Beckmann  <marcelobeckmann@yahoo.com>  (tradução)  Espaço  para  o  Revisor
       <nome@dominio.com.br> (revisão)