.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" 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.
+.\" %%%LICENSE_END
.\"
.\" References consulted:
.\" GNU glibc-2 source code and manual
.\" Dinkumware C library reference http://www.dinkumware.com/
-.\" OpenGroup's Single Unix specification
+.\" OpenGroup's Single UNIX specification
.\" http://www.UNIX-systems.org/online.html
.\" ISO/IEC 9899:1999
.\"
.\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
-.TH FGETWC 3 1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH FGETWC 3 2013-04-19 "GNU" "Linux Programmer's Manual"
.SH NAME
fgetwc, getwc \- read a wide character from a FILE stream
.SH SYNOPSIS
.PP
For nonlocking counterparts, see
.BR unlocked_stdio (3).
-.SH "RETURN VALUE"
+.SH RETURN VALUE
The
.BR fgetwc ()
function returns the next wide-character
from the stream, or
.BR WEOF .
+In the event of an error,
+.I errno
+is set to indicate the cause.
.SH ERRORS
Apart from the usual ones, there is
.TP
.B EILSEQ
The data obtained from the input stream does not
form a valid character.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
C99, POSIX.1-2001.
.SH NOTES
The behavior of
.BR fgetwc ()
will actually read a multibyte sequence
from the stream and then convert it to a wide character.
-.SH "SEE ALSO"
+.SH SEE ALSO
.BR fgetws (3),
.BR fputwc (3),
.BR ungetwc (3),
.BR unlocked_stdio (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.