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

NOMBRE

       wcrtomb - convierte una caracter ancho a un secuencia multibyte

SINOPSIS

       #include <wchar.h>

       size_t wcrtomb (char *s, wchar_t wc, mbstate_t *ps);

DESCRIPCI'ON

       El  caso  principal  de  esta funcion es cuando s no es NULL y wc no es
       L'\0'.  En este caso, la funcion wcrtomb 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  *ps,  y
       devuelve  la  longitud de la susodicha representacion multibyte, o sea,
       el numero de bytes escritos en  s.

       Un caso diferente es cuando s no es  NULL pero wc  es  L'\0'.   En  ese
       caso, la funcion wcrtomb guarda en la cadena de caracteres apuntada por
       s la secuencia de cambios necesaria  para  devolver  *ps  a  su  estado
       inicial,  seguido por un byte '\0'.  Actualiza el estado de cambios *ps
       (es decir, lo devuelve al estado inicial) y  devuelve la longitud de la
       secuencia  de cambios mas uno, es decir, el numero de bytes escritos en
       s.

       Un tercer caso es cuando s es NULL. En este caso wc  se  ignora,  y  la
       funcion  devuelve  efectivamente  wcrtomb(buf,L'\0',ps) donde buf es un
       buffer anonimo interno.

       En todos los casos anteriores, si ps es un puntero NULL, se usa  en  su
       lugar un estado estatico anonimo solo conocido por la funcion wcrtomb.

VALOR DEVUELTO

       La  funcion  wcrtomb  devuelve el numero de bytes que han sido o serian
       escritos en el array de bytes s. Si wc no se puede representar como  un
       secuencia  multibyte  (de  acuerdo  a la localizacion actual), devuelve
       (size_t)(-1) y errno se pone con el valor EILSEQ.

CONFORME A

       ISO/ANSI C, UNIX98

V'EASE TAMBI'EN

       wcsrtombs(3)

OBSERVACIONES

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

       Pasar NULL como ps no es seguro en entornos multihilo.