1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
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 2013-04-19 "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
61 In the event of an error,
63 is set to indicate the cause.
65 Apart from the usual ones, there is
68 The data obtained from the input stream does not
69 form a valid character.
80 In the absence of additional information passed to the
83 reasonable to expect that
85 will actually read a multibyte sequence
86 from the stream and then convert it to a wide character.
91 .BR unlocked_stdio (3)
93 This page is part of release 3.67 of the Linux
96 A description of the project,
97 information about reporting bugs,
98 and the latest version of this page,
100 \%http://www.kernel.org/doc/man\-pages/.