SISCANF(3)

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

SYNOPSIS
     #include <stdio.h>
     int iscanf(const char *FORMAT, ...);
     int fiscanf(FILE *FD, const char *FORMAT, ...);
     int siscanf(const char *STR, const char *FORMAT, ...);
     int _iscanf_r(struct _reent *PTR, const char *FORMAT, ...);
     int _fiscanf_r(struct _reent *PTR, FILE *FD,
         const char *FORMAT, ...);
     int _siscanf_r(struct _reent *PTR, const char *STR,
         const char *FORMAT, ...);

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'.

SEE ALSO
siscanf is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.