Penguin
Recent Changes
Annotated edit history of ungetwc(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 UNGETWC
2 !!!UNGETWC
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 CONFORMING TO
8 SEE ALSO
9 NOTES
10 ----
11 !!NAME
12
13
14 ungetwc - push back a wide character onto a FILE stream
15 !!SYNOPSIS
16
17
18 __#include
19 __ ''wc''__, FILE *__''stream''__);
20 __
21 !!DESCRIPTION
22
23
24 The __ungetwc__ function is the wide-character equivalent
25 of the __ungetc__ function. It pushes back a wide
26 character onto ''stream'' and returns it.
27
28
29 If ''wc'' is WEOF, it returns WEOF. If ''wc'' is an
30 invalid wide character, it sets __errno__ to
31 __EILSEQ__ and returns WEOF.
32
33
34 If ''wc'' is a valid wide character, it is pushed back
35 onto the stream and thus becomes available for future wide
36 character read operations. The file-position indicator is
37 decremented by one or more. The end-of-file indicator is
38 cleared. The backing storage of the file is not
39 affected.
40
41
42 Note: ''wc'' need not be the last wide character read
43 from the stream; it can be any other valid wide
44 character.
45
46
47 If the implementation supports multiple push-back operations
48 in a row, the pushed-back wide characters will be read in
49 reverse order; however, only one level of push-back is
50 guaranteed.
51 !!RETURN VALUE
52
53
54 The __ungetwc__ function returns ''wc'' when
55 successful, or WEOF upon failure.
56 !!CONFORMING TO
57
58
59 ISO/ANSI C, UNIX98
60 !!SEE ALSO
61
62
63 fgetwc(3)
64 !!NOTES
65
66
67 The behaviour of __ungetwc__ depends on the LC_CTYPE
68 category of the current locale.
69 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.