NOMBRE

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

BIBLIOTECA

Biblioteca Estándar C (libc, -lc)

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.

ATRIBUTOS

Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

VERSIONES

La función wcrtomb(3) proporciona un interfaz mejor con la misma funcionalidad.

ESTÁNDARES

C11, POSIX.1-2008.

HISTORIAL

POSIX.1-2001, C99.

NOTAS

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

VÉASE TAMBIÉN

MB_CUR_MAX(3), mblen(3), mbstowcs(3), mbtowc(3), wcrtomb(3), wcstombs(3)

TRADUCCIÓN

La traducción al español de esta página del manual fue creada por Pedro Pablo Fábrega <pfabrega@arrakis.es> y Juan Piernas <piernas@ditec.um.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.