Ubuntu manuals

Provided by: manpages-es_1.55-10_all

NOMBRE

       wctomb - convierte una caracter ancho a un secuencia multibyte

SINOPSIS

       #include <stdlib.h>

       int wctomb (char *s, wchar_t wc);

DESCRIPCI'ON

       Si  s no es NULL, la funcion wctomb convierte el caracter ancho wc a su
       representacion 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 anonima solo  conocida  por  la  funcion
       wctomb,  y  devuelve  la longitud de dicha representacion multibyte, es
       decir, el numero 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 funcion wctomb reinicia el estado de cambios, solo
       conocido por esta funcion, al estado inicial y  devuelve  un  valor  no
       nulo  si  la codificacion tiene un estado de cambios no trivial, o cero
       si la codificacion no tiene estado.

VALOR DEVUELTO

       Si s no es nulo, la funcion wctomb devuelve el numero 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  localizacion  actual),
       devuelve -1.

       Si  s  es  nulo,  la  funcion  wctomb  devuelve  un valor no nulo si la
       codificacion tiene un estado de  cambios  no  trivial,  o  cero  si  la
       codificacion no tiene estado.

CONFORME A

       ISO/ANSI C, UNIX98

V'EASE TAMBI'EN

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

OBSERVACIONES

       El  comportamiento  de  wctomb  depende  de la categoria LC_CTYPE de la
       localizacion actual.

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