VISCANF(3) NEWLIB VISCANF(3)NAME
4.73 `viscanf', `vfiscanf', `vsiscanf'--format argument list
SYNOPSIS
#include <stdio.h>
#include <stdarg.h>
int viscanf(const char *FMT, va_list LIST);
int vfiscanf(FILE *FP, const char *FMT, va_list LIST);
int vsiscanf(const char *STR, const char *FMT, va_list LIST);
int _viscanf_r(struct _reent *REENT, const char *FMT,
va_list LIST);
int _vfiscanf_r(struct _reent *REENT, FILE *FP, const char *FMT,
va_list LIST);
int _vsiscanf_r(struct _reent *REENT, const char *STR,
const char *FMT, va_list LIST);
DESCRIPTION
`viscanf', `vfiscanf', and `vsiscanf' are (respectively) variants of
`iscanf', `fiscanf', and `siscanf'. They differ only in allowing their
caller to pass the variable argument list as a `va_list' object (ini‐
tialized by `va_start') rather than directly accepting a variable num‐
ber of arguments.
RETURNS
The return values are consistent with the corresponding functions:
`viscanf' returns the number of input fields successfully scanned, con‐
verted, and stored; the return value does not include scanned fields
which were not stored.
If `viscanf' attempts to read at end-of-file, the return value is
`EOF'.
If no fields were stored, the return value is `0'.
The routines `_viscanf_r', `_vfiscanf_f', and `_vsiscanf_r' are
reentrant versions which take an additional first parameter which
points to the reentrancy structure.
PORTABILITY
These are newlib extensions.
Supporting OS subroutines required:
SEE ALSOviscanf is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 VISCANF(3)