.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" Traducida por Pedro Pablo Fábrega <pfabrega@arrakis.es>
.\" Esto es documentación libre; puede redistribuirla y/o
.\" modificarla bajo los términos de la Licencia Pública General GNU
.\" publicada por la Free Software Foundation; bien la versión 2 de
.\" la Licencia o (a su elección) cualquier versión posterior.
.\"
.\" Referencias consultadas:
.\"   código fuente y manual de glibc-2 GNU
.\"   referencia de la bibliote C Dinkumware http://www.dinkumware.com/
.\"   Especificaciones Single Unix de OpenGroup http://www.UNIX-systems.org/onl
.\"
.\" Translation revised Wed Aug  2 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH WCTOMB 3  "25 julio 1999" "GNU" "Manual del Programador Linux"
.SH NOMBRE
wctomb \- convierte una carácter ancho a un secuencia multibyte
.SH SINOPSIS
.nf
.B #include <stdlib.h>
.sp
.BI "int wctomb (char *" s ", wchar_t " wc );
.fi
.SH DESCRIPCIÓN
Si \fIs\fP no es NULL, la función \fBwctomb\fP convierte 
el carácter ancho \fIwc\fP a su representación multibyte 
y lo guarda al principio de la cadena de caracteres apuntada 
por \fIs\fP. 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 \fIs\fP.
.PP
El programador tiene que asegurarse de que hay suficiente espacio para 
al menos \fBMB_CUR_MAX\fP bytes en \fIs\fP.
.PP
Si \fIs\fP es NULL, la función \fBwctomb\fP 
.\" La docum Dinkumware y la especificación Single Unix 
.\" dice esto, pero
.\" glibc no desarrolla esto.
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.
.SH "VALOR DEVUELTO"
Si \fIs\fP no es nulo, la función \fBwctomb\fP devuelve el número de 
bytes que han sido escritos en el vector de bytes \fIs\fP. Si \fIwc\fP
no se puede representar como un secuencia multibyte (de acuerdo
a la localización actual), devuelve \-1.
.PP
Si \fIs\fP es nulo, la función \fBwctomb\fP 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.
.SH "CONFORME A"
ISO/ANSI C, UNIX98
.SH "VÉASE TAMBIÉN"
.BR wcrtomb "(3), " wcstombs "(3), " MB_CUR_MAX (3)
.SH OBSERVACIONES
El comportamiento de \fBwctomb\fP depende de la categoría LC_CTYPE
de la localización actual.
.PP
Esta función no es segura para multihilo. La función \fBwcrtomb\fP
proporciona un interfaz mejor con la misma funcionalidad.