~ubuntu-branches/ubuntu/precise/manpages-posix/precise

1 by Francesco Paolo Lovergine
rules: linking manpages-posix not manpages.
1
.\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved 
2 by Francesco Paolo Lovergine
* Alligned to linux main manpages edition.
2
.TH "VFWSCANF" P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
1 by Francesco Paolo Lovergine
rules: linking manpages-posix not manpages.
3
.\" vfwscanf 
4
.SH NAME
5
vfwscanf, vswscanf, vwscanf \- wide-character formatted input of a
6
stdarg argument list
7
.SH SYNOPSIS
8
.LP
9
\fB#include <stdarg.h>
10
.br
11
#include <stdio.h>
12
.br
13
#include <wchar.h>
14
.br
15
.sp
16
int vfwscanf(FILE *restrict\fP \fIstream\fP\fB, const wchar_t *restrict\fP
17
\fIformat\fP\fB,
18
.br
19
\ \ \ \ \ \  va_list\fP \fIarg\fP\fB);
20
.br
21
int vswscanf(const wchar_t *restrict\fP \fIws\fP\fB, const wchar_t
22
*restrict\fP \fIformat\fP\fB,
23
.br
24
\ \ \ \ \ \  va_list\fP \fIarg\fP\fB);
25
.br
26
int vwscanf(const wchar_t *restrict\fP \fIformat\fP\fB, va_list\fP
27
\fIarg\fP\fB);
28
.br
29
\fP
30
.SH DESCRIPTION
31
.LP
32
The \fIvfwscanf\fP(), \fIvswscanf\fP(), and \fIvwscanf\fP() functions
33
shall be equivalent to the \fIfwscanf\fP(), \fIswscanf\fP(), and \fIwscanf\fP()
34
functions, respectively, except that instead of being called with
35
a variable number
36
of arguments, they are called with an argument list as defined in
37
the \fI<stdarg.h>\fP header. These functions shall not invoke the
38
\fIva_end\fP macro. As these
39
functions invoke the \fIva_arg\fP macro, the value of \fIap\fP after
40
the return is unspecified.
41
.SH RETURN VALUE
42
.LP
43
Refer to \fIfwscanf\fP() .
44
.SH ERRORS
45
.LP
46
Refer to \fIfwscanf\fP() .
47
.LP
48
\fIThe following sections are informative.\fP
49
.SH EXAMPLES
50
.LP
51
None.
52
.SH APPLICATION USAGE
53
.LP
54
Applications using these functions should call \fIva_end\fP( \fIap\fP)
55
afterwards to clean up.
56
.SH RATIONALE
57
.LP
58
None.
59
.SH FUTURE DIRECTIONS
60
.LP
61
None.
62
.SH SEE ALSO
63
.LP
64
\fIfwscanf\fP() , the Base Definitions volume of IEEE\ Std\ 1003.1-2001,
65
\fI<stdarg.h>\fP, \fI<stdio.h>\fP, \fI<wchar.h>\fP
66
.SH COPYRIGHT
67
Portions of this text are reprinted and reproduced in electronic form
68
from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
69
-- Portable Operating System Interface (POSIX), The Open Group Base
70
Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
71
Electrical and Electronics Engineers, Inc and The Open Group. In the
72
event of any discrepancy between this version and the original IEEE and
73
The Open Group Standard, the original IEEE and The Open Group Standard
74
is the referee document. The original Standard can be obtained online at
75
http://www.opengroup.org/unix/online.html .