getwc(3c) - osol9

1getwc(3C)                Standard C Library Functions                getwc(3C)
2
3
4

NAME

6       getwc - get 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 is equivalent to fgetwc(3C), except that if it is
17       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 VALUES

21       Refer to fgetwc(3C).
22

ERRORS

24       Refer to fgetwc(3C).
25

USAGE

27       This  interface  is provided to align with some current implementations
28       and with possible future ISO standards.
29
30
31       Because it may be implemented as a macro, getwc() may treat incorrectly
32       a  stream  argument  with side effects.  In particular, getwc(*f++) may
33       not work as expected.  Therefore, use of this function  is  not  recom‐
34       mended; fgetwc(3C) should be used instead.
35

ATTRIBUTES

37       See attributes(5) for descriptions of the following attributes:
38
39
40
41
42       ┌─────────────────────────────┬─────────────────────────────┐
43       │ATTRIBUTE TYPE               │ATTRIBUTE VALUE              │
44       ├─────────────────────────────┼─────────────────────────────┤
45       │Interface Stability          │Standard                     │
46       ├─────────────────────────────┼─────────────────────────────┤
47       │MT-Level                     │MT-Safe                      │
48       └─────────────────────────────┴─────────────────────────────┘
49