Manpage of VISCANF

VISCANF

Section: NEWLIB (3)
Updated: 2005 Feb 23
Index Return to Main Contents

NAME

3.53 `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 (initialized by `va_start') rather than directly accepting a variable number of arguments.

RETURNS

The return values are consistent with the corresponding functions: `viscanf' returns the number of input fields successfully scanned, converted, 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:

This document was created by man2html, using the manual pages.
Time: 21:25:33 GMT, May 16, 2005