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).
       ┌──────────────────────────────────────────────────────────┬────────────────────┬───────────────────────┐
       │ Interfaz                                                 │ Atributo           │ Valor                 │
       ├──────────────────────────────────────────────────────────┼────────────────────┼───────────────────────┤
       │ wctomb()                                                 │ Seguridad del hilo │ MT - Carrera insegura │
       └──────────────────────────────────────────────────────────┴────────────────────┴───────────────────────┘

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.

Páginas de Manual de Linux 6.9.1                   2 Mayo 2024                                         wctomb(3)