Manpage of ISCANF

ISCANF

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

NAME

3.47 `iscanf', `fiscanf', `siscanf'--scan and format non-floating input

SYNOPSIS

#include <stdio.h>

     int iscanf(const char *FORMAT [, ARG, ...]);
     int fiscanf(FILE *FD, const char *FORMAT [, ARG, ...]);
     int siscanf(const char *STR, const char *FORMAT
         [, ARG, ...]);

     int _iscanf_r(struct _reent *PTR, const char *FORMAT [, ARG, ...]);
     int _fiscanf_r(struct _reent *PTR, FILE *FD, const char *FORMAT [, ARG, ...]);
     int _siscanf_r(struct _reent *PTR, const char *STR, const char *FORMAT
         [, ARG, ...]);

DESCRIPTION

`iscanf', `fiscanf', and `siscanf' are the same as `scanf', `fscanf', and `sscanf' respectively, only that they restrict the available formats to non-floating-point format specifiers.

The routines `_iscanf_r', `_fiscanf_r', and `_siscanf_r' are reentrant versions of `iscanf', `fiscanf', and `siscanf' that take an additional first argument pointing to a reentrancy structure.

RETURNS

`iscanf' returns the number of input fields successfully scanned, converted and stored; the return value does not include scanned fields which were not stored.

If `iscanf' attempts to read at end-of-file, the return value is `EOF'.

If no fields were stored, the return value is `0'.

PORTABILITY

`iscanf', `fiscanf', and `siscanf' are newlib extensions.

Supporting OS subroutines required: `close', `fstat', `isatty', `lseek', `read', `sbrk', `write'.

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