.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, Bruno Haible <bruno@clisp.org>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wctomb 3 "8 Febrero 2026" "Linux man\-pages 6.18" 
.SH NOMBRE
wctomb \- convierte una carácter ancho a un secuencia multibyte
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <stdlib.h>\fP
.P
\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.
.P
At most \fBMB_CUR_MAX\fP bytes will be written at \fIs\fP.  The programmer must
ensure that there is enough room to store the multibyte sequence at \fIs\fP.
.P
.\" 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.
.P
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;
lbx lb lb
l l l.
Interfaz	Atributo	Valor
T{
.na
.nh
\fBwctomb\fP()
T}	Seguridad del hilo	MT \- Carrera insegura
.TE
.SH VERSIONES
La función \fBwcrtomb\fP(3) proporciona un interfaz mejor con la misma
funcionalidad.
.SH ESTÁNDARES
C11, POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001, C99.
.SH NOTAS
El comportamiento de \fBwctomb\fP() depende de la categoría \fBLC_CTYPE\fP de la
localización actual.
.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)
.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 .