1GETWC(P)                   POSIX Programmer's Manual                  GETWC(P)
2
3
4

NAME

6       getwc - get a wide character from a stream
7

SYNOPSIS

9       #include <stdio.h>
10       #include <wchar.h>
11
12       wint_t getwc(FILE *stream);
13
14

DESCRIPTION

16       The getwc() function shall be equivalent to fgetwc(), except that if it
17       is implemented as a macro it may evaluate stream more than once, so the
18       argument should never be an expression with side effects.
19

RETURN VALUE

21       Refer to fgetwc() .
22

ERRORS

24       Refer to fgetwc() .
25
26       The following sections are informative.
27

EXAMPLES

29       None.
30

APPLICATION USAGE

32       Since it may be implemented as a macro, getwc() may treat incorrectly a
33       stream argument with side effects. In particular, getwc(*f++) does  not
34       necessarily  work  as expected.  Therefore, use of this function is not
35       recommended; fgetwc() should be used instead.
36

RATIONALE

38       None.
39

FUTURE DIRECTIONS

41       None.
42

SEE ALSO

44       fgetwc()  ,  the  Base  Definitions  volume  of   IEEE Std 1003.1-2001,
45       <stdio.h>, <wchar.h>
46

48       Portions  of  this text are reprinted and reproduced in electronic form
49       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
50       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
51       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
52       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
53       event of any discrepancy between this version and the original IEEE and
54       The  Open Group Standard, the original IEEE and The Open Group Standard
55       is the referee document. The original Standard can be  obtained  online
56       at http://www.opengroup.org/unix/online.html .
57
58
59
60IEEE/The Open Group                  2003                             GETWC(P)
Impressum