Section: Manual del Programador Linux (3)
Updated: 25 julio 1999
Index Return to Main
Contents
wctomb - convierte una carácter ancho a un secuencia multibyte
#include <stdlib.h> int wctomb (char *s, wchar_t wc);
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.
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.
(3), wcstombs(3), MB_CUR_MAX(3)
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.
This document was created by man2html, using
the manual pages.
Time: 06:16:26 GMT, January 22, 2005