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
|
.\" 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 Sun Apr 23 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH UNGETWC 3 "19 septiembre 1999" "GNU" "Manual del Programador de Linux"
.SH NOMBRE
ungetwc \- vuelve a colocar un carcter ancho en un flujo FILE
.SH SINOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "wint_t ungetwc (wint_t " wc ", FILE *" stream ");
.fi
.SH DESCRIPCION
La funcin \fBungetwc\fP es equivalente para caracteres anchos a la funcin
\fBungetc\fP. Esta funcin vuelve a colocar un carcter ancho en el flujo
\fIstream\fP, devolviendo dicho carcter.
.PP
Si \fIwc\fP es WEOF, devuelve WEOF. Si \fIwc\fP es un carcter ancho
invlido, asigna a \fBerrno\fP el valor \fBEILSEQ\fP y devuelve WEOF.
.PP
Si \fIwc\fP es un carcter ancho vlido, se reinserta en el flujo
y, por tanto, estar disponible para futuras operaciones de lectura de
caracteres anchos. El indicador de posicin del fichero se reduce en uno o
ms. El indicador de fin-de-fichero se limpia. El almacenamiento de respaldo
del fichero no se ve afectado.
.PP
Nota: no es necesario que \fIwc\fP sea el ltimo carcter ancho ledo del
flujo. Puede ser cualquier otro carcter ancho vlido.
.PP
Si la implementacin soporta mltiples operaciones de reinsercin, los
caracteres anchos reinsertados se leern en orden inverso. No obstante, slo
se garantiza un nivel de reinsercin.
.SH "VALOR DEVUELTO"
La funcin \fBungetwc\fP devuelve \fIwc\fP en caso de xito, o WEOF en caso
de fallo.
.SH "CONFORME A"
ISO/ANSI C, UNIX98
.SH "VASE TAMBIN"
.BR fgetwc (3)
.SH OBSERVACIONES
El comportamiento de \fBungetwc\fP depende de la categora LC_CTYPE de la
localizacin actual.
|
