.\" -*- coding: UTF-8 -*-
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\" %%%LICENSE_END
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH WCTOMB 3 "8 Agosto 2015" GNU "Manual del Programador de Linux"
.SH NOMBRE
wctomb \- convierte una carácter ancho a un secuencia multibyte
.SH SINOPSIS
.nf
\fB#include <stdlib.h>\fP
.PP
\fBint wctomb(char *\fP\fIs\fP\fB, wchar_t \fP\fIwc\fP\fB);\fP
.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 \fBwctomb\fP(), 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
.\" The Dinkumware doc and the Single UNIX specification say this, but
.\" glibc doesn't implement this.
Si \fIs\fP es NULL, la función \fBwctomb\fP() 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 ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lb lb lb
l l l.
Interfaz	Atributo	Valor
T{
\fBwctomb\fP()
T}	Seguridad del hilo	MT \- Carrera insegura
.TE
.SH "CONFORME A"
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH NOTAS
El comportamiento de \fBwctomb\fP() depende de la categoría \fBLC_CTYPE\fP de la
localización actual.
.PP
La función \fBwcrtomb\fP(3) proporciona un interfaz mejor con la misma
funcionalidad.
.SH "VÉASE TAMBIÉN"
\fBMB_CUR_MAX\fP(3), \fBmblen\fP(3), \fBmbstowcs\fP(3), \fBmbtowc\fP(3), \fBwcrtomb\fP(3),
\fBwcstombs\fP(3)
.SH COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux
\fIman\-pages\fP. Puede encontrar una descripción del proyecto, información
sobre cómo informar errores y la última versión de esta página en
\%https://www.kernel.org/doc/man\-pages/.
.PP
.SH 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>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .