Penguin
Recent Changes
Annotated edit history of getwc(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 FGETWC
2 !!!FGETWC
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 ERRORS
8 CONFORMING TO
9 SEE ALSO
10 NOTES
11 ----
12 !!NAME
13
14
15 fgetwc - read a wide character from a FILE stream
16 !!SYNOPSIS
17
18
19 __#include
20 __ ''stream''__);
21 wint_t getwc (FILE*__ ''stream''__);
22 __
23 !!DESCRIPTION
24
25
26 The __fgetwc__ function is the wide-character equivalent
27 of the __fgetc__ function. It reads a wide character from
28 ''stream'' and returns it. If the end of stream is
29 reached, or if ''ferror(stream)'' becomes true, it
30 returns WEOF. If a wide character conversion error occurs,
31 it sets __errno__ to __EILSEQ__ and returns
32 WEOF.
33
34
35 The __getwc__ function or macro functions identically to
36 __fgetwc__. It may be implemented as a macro, and may
37 evaluate its argument more than once. There is no reason
38 ever to use it.
39 !!RETURN VALUE
40
41
42 The __fgetwc__ function returns the next wide-character
43 from the stream, or WEOF.
44 !!ERRORS
45
46
47 Apart from the usual ones, there is
48
49
50 __EILSEQ__
51
52
53 The data obtained from the input stream does not form a
54 valid character.
55 !!CONFORMING TO
56
57
58 ISO/ANSI C, UNIX98
59 !!SEE ALSO
60
61
62 fputwc(3), fgetws(3),
63 ungetwc(3)
64 !!NOTES
65
66
67 The behaviour of __fgetwc__ depends on the LC_CTYPE
68 category of the current locale.
69
70
71 In the absence of additional information passed to the fopen
72 call, it is reasonable to expect that __fgetwc__ will
73 actually read a multibyte sequence from the stream and then
74 convert it to a wide character.
75 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.