1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" Traducida por Pedro Pablo Fbrega <pfabrega@arrakis.es>
.\" Esto es documentacin libre; puede redistribuirla y/o
.\" modificarla bajo los trminos de la Licencia Pblica General GNU
.\" publicada por la Free Software Foundation; bien la versin 2 de
.\" la Licencia o (a su eleccin) cualquier versin posterior.
.\"
.\" Referencias consultadas:
.\" cdigo 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
.\" ISO/IEC 9899:1999
.\"
.\" Translation revised Wed Aug 2 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH WCRTOMB 3 "25 julio 1999" "GNU" "Manual del Programador Linux"
.SH NOMBRE
wcrtomb \- convierte una carcter ancho a un secuencia multibyte
.SH SINOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "size_t wcrtomb (char *" s ", wchar_t " wc ", mbstate_t *" ps );
.fi
.SH DESCRIPCIN
El caso principal de esta funcin es cuando \fIs\fP no es NULL y \fIwc\fP
no es L'\\0'.
En este caso, la funcin \fBwcrtomb\fP convierte el carcter
ancho \fIwc\fP a su representacin multibyte y lo guarda
al principio de la cadena de caracteres apuntada por \fIs\fP.
Actualiza el estado de cambios \fI*ps\fP, y devuelve la longitud de la
susodicha representacin multibyte, o sea, el nmero de bytes
escritos en \fIs\fP.
.PP
Un caso diferente es cuando \fIs\fP no es NULL pero \fIwc\fP es L'\\0'.
En ese caso, la funcin \fBwcrtomb\fP guarda en la cadena de caracteres
apuntada por \fIs\fP la secuencia de cambios necesaria para
devolver \fI*ps\fP a su estado inicial, seguido por un byte '\\0'.
Actualiza el estado de cambios \fI*ps\fP (es decir, lo devuelve al estado
inicial) y devuelve la longitud de la secuencia de cambios ms uno, es
decir, el nmero de bytes escritos en \fIs\fP.
.PP
Un tercer caso es cuando \fIs\fP es NULL. En este caso \fIwc\fP se
ignora, y la funcin devuelve efectivamente wcrtomb(buf,L'\\0',\fIps\fP)
donde buf es un buffer annimo interno.
.PP
En todos los casos anteriores, si \fIps\fP es un puntero NULL,
se usa en su lugar un estado esttico annimo slo conocido por
la funcin wcrtomb.
.SH "VALOR DEVUELTO"
La funcin \fBwcrtomb\fP devuelve el nmero de bytes que han sido
o seran escritos en el array de bytes \fIs\fP. Si \fIwc\fP
no se puede representar como un secuencia multibyte (de acuerdo
a la localizacin actual), devuelve (size_t)(-1) y \fBerrno\fP se pone
con el valor \fBEILSEQ\fP.
.SH "CONFORME A"
ISO/ANSI C, UNIX98
.SH "VASE TAMBIN"
.BR wcsrtombs (3)
.SH NOTAS
El comportamiento de \fBwcrtomb\fP depende de la categora LC_CTYPE
de la localizacin actual.
.PP
Pasar NULL como \fIps\fP no es seguro en entornos multihilo.
|
