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 2015-08-08 "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.
71 For an explanation of the terms used in this section, see
77 Interface Attribute Value
81 T} Thread safety MT-Safe
84 POSIX.1-2001, POSIX.1-2008, C99.
93 In the absence of additional information passed to the
96 reasonable to expect that
98 will actually read a multibyte sequence
99 from the stream and then convert it to a wide character.
104 .BR unlocked_stdio (3)