1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_ONEPARA_DOC)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification
14 .\" http://www.UNIX-systems.org/online.html
17 .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
18 .TH FGETWC 3 1999-07-25 "GNU" "Linux Programmer's Manual"
20 fgetwc, getwc \- read a wide character from a FILE stream
27 .BI "wint_t fgetwc(FILE *" stream );
28 .BI "wint_t getwc(FILE *" stream );
33 function is the wide-character equivalent
37 It reads a wide character from \fIstream\fP and returns it.
38 If the end of stream is reached, or if \fIferror(stream)\fP becomes true,
41 If a wide-character conversion error occurs, it sets
42 \fIerrno\fP to \fBEILSEQ\fP and returns
47 function or macro functions identically to
49 It may be implemented as a macro, and may evaluate its argument
51 There is no reason ever to use it.
53 For nonlocking counterparts, see
54 .BR unlocked_stdio (3).
58 function returns the next wide-character
62 Apart from the usual ones, there is
65 The data obtained from the input stream does not
66 form a valid character.
77 In the absence of additional information passed to the
80 reasonable to expect that
82 will actually read a multibyte sequence
83 from the stream and then convert it to a wide character.
88 .BR unlocked_stdio (3)