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
66
67
68
69
70
71
72
73
74
75
76
|
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" 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.
.\"
.\" 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
.\"
.\" Translated Tue Apr 25 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH MBSRTOWCS 3 "25 julio 1999" "GNU" "Manual del Programador de Linux"
.SH NOMBRE
mbsrtowcs \- convierte una cadena multibyte a una cadena de caracteres anchos
.SH SINOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "size_t mbsrtowcs (wchar_t *" dest ", const char **" src ,
.BI " size_t " len ", mbstate_t *" ps );
.fi
.SH DESCRIPCIN
Si \fIdest\fP no es un puntero NULL, la funcin \fBmbsrtowcs\fP convierte la
cadena multibyte \fI*src\fP a una cadena de caracteres anchos que comienza
en \fIdest\fP. Como mucho, se escriben \fIlen\fP caracteres anchos en
\fIdest\fP. El estado de cambios \fI*ps\fP se actualiza. La conversin se
realiza en realidad llamando repetidamente a
mbrtowc(\fIdest\fP,\fI*src\fP,\fIn\fP,\fIps\fP), donde \fIn\fP es algn
nmero positivo tal que esta llamada tenga xito, e incrementando
a continuacin \fIdest\fP en uno y \fI*src\fP en el nmero de bytes
consumidos. La conversin se puede detener por tres razones:
.PP
1. Se encuentar una secuencia multibyte invlida. En este caso se deja
\fI*src\fP apuntando a la secuencia multibyte invlida, la funcin devuelve
(size_t)(-1) y se asigna a \fBerrno\fP el valor \fBEILSEQ\fP.
.PP
2. Se han almacenado \fIlen\fP caracteres anchos distintos de L'\\0' en
\fIdest\fP. En este caso, \fI*src\fP se deja apuntado a la siguiente
secuencia multibyte a convertir y la funcin devuelve el nmero de
caracteres anchos escritos en \fIdest\fP.
.PP
3. Se ha convertido completamente la cadena multibyte, incluyendo el
carcter terminador '\\0' (que tiene el efecto colateral de devolver a
\fI*ps\fP al estado inicial). En este caso, se asigna a \fI*src\fP el valor
NULL y la funcin devuelve el nmero de caracteres anchos escritos en
\fIdest\fP, excluyendo el carcter terminador L'\\0'.
.PP
Si \fIdest\fP es NULL, se ignora \fIlen\fP y la conversin procede como
antes salvo que no se escriben en memoria los caracteres anchos obtenidos y
que no existe lmite en la longitud.
.PP
En los dos casos anteriores, si \fIps\fP es un puntero NULL, se utiliza en
su lugar un estado annimo privado, slo conocido por la funcin
\fBmbsrtowcs\fP.
.PP
El programador debe garantizar que hay espacio suficiente en \fIdest\fP para,
al menos, \fIlen\fP caracteres anchos.
.SH "VALOR DEVUELTO"
La funcin \fBmbsrtowcs\fP devuelve el nmero de caracteres anchos que
componen la parte convertida de la cadena de caracteres anchos, sin incluir
el carcter ancho terminador nulo. Si se encuentra una secuencia multibyte
invlida, se devuelve (size_t)(-1) y se asigna a \fBerrno\fP el valor
\fBEILSEQ\fP.
.SH "CONFORME A"
ISO/ANSI C, UNIX98
.SH "VASE TAMBIN"
.BR mbstowcs "(3), " mbsnrtowcs "(3), " iconv (3)
.SH OBSERVACIONES
El comportamiento de \fBmbsrtowcs\fP depende de la categora LC_CTYPE de la
localizacin actual.
.PP
Pasar NULL como valor de \fIps\fP no es seguro en un entorno multihilos.
|
