Provided by:
manpages-es_1.55-10_all 
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.