Provided by: manpages-es_1.55-3_all bug

NOMBRE

       wctomb - convierte una carácter ancho a un secuencia multibyte

SINOPSIS

       #include <stdlib.h>

       int wctomb (char *s, wchar_t wc);

DESCRIPCIÓN

       Si  s no es NULL, la función wctomb convierte el carácter ancho wc a su
       representación multibyte y lo guarda  al  principio  de  la  cadena  de
       caracteres  apuntada  por  s.  Actualiza  el  estado de cambios, que se
       guarda en una variable privada anónima sólo  conocida  por  la  función
       wctomb,  y  devuelve  la longitud de dicha representación multibyte, es
       decir, el número de bytes escritos en s.

       El programador tiene que asegurarse de que hay suficiente espacio  para
       al menos MB_CUR_MAX bytes en s.

       Si  s  es  NULL,  la función wctomb reinicia el estado de cambios, sólo
       conocido por esta función, al estado inicial y  devuelve  un  valor  no
       nulo  si  la codificación tiene un estado de cambios no trivial, o cero
       si la codificación no tiene estado.

VALOR DEVUELTO

       Si s no es nulo, la función wctomb devuelve el número de bytes que  han
       sido  escritos  en  el vector de bytes s. Si wc no se puede representar
       como un secuencia multibyte (de  acuerdo  a  la  localización  actual),
       devuelve -1.

       Si  s  es  nulo,  la  función  wctomb  devuelve  un valor no nulo si la
       codificación tiene un estado de  cambios  no  trivial,  o  cero  si  la
       codificación no tiene estado.

CONFORME A

       ISO/ANSI C, UNIX98

VÉASE TAMBIÉN

       wcrtomb(3), wcstombs(3), MB_CUR_MAX(3)

OBSERVACIONES

       El  comportamiento  de  wctomb  depende  de la categoría LC_CTYPE de la
       localización actual.

       Esta  función  no  es  segura  para  multihilo.  La   función   wcrtomb
       proporciona un interfaz mejor con la misma funcionalidad.