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

NAME

6       putwc - put a wide character on a stream
7

SYNOPSIS

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

DESCRIPTION

16       The putwc() function shall be equivalent to fputwc(), 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 fputwc() .
22

ERRORS

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

EXAMPLES

29       None.
30

APPLICATION USAGE

32       Since  it  may  be  implemented  as a macro, putwc() may treat a stream
33       argument with side effects incorrectly. In  particular,  putwc(wc,*f++)
34       need not work correctly.  Therefore, use of this function is not recom‐
35       mended; fputwc() should be used instead.
36

RATIONALE

38       None.
39

FUTURE DIRECTIONS

41       None.
42

SEE ALSO

44       fputwc()  ,  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                             PUTWC(P)
Impressum