www.delorie.com/gnu/docs/glibc/libc_217.html   search  
 
Buy the book!


The GNU C Library

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

12.14.9 Variable Arguments Input Functions

The functions vscanf and friends are provided so that you can define your own variadic scanf-like functions that make use of the same internals as the built-in formatted output functions. These functions are analogous to the vprintf series of output functions. See section 12.12.9 Variable Arguments Output Functions, for important information on how to use them.

Portability Note: The functions listed in this section were introduced in ISO C99 and were before available as GNU extensions.

Function: int vscanf (const char *template, va_list ap)
This function is similar to scanf, but instead of taking a variable number of arguments directly, it takes an argument list pointer ap of type va_list (see section A.2 Variadic Functions).

Function: int vwscanf (const wchar_t *template, va_list ap)
This function is similar to wscanf, but instead of taking a variable number of arguments directly, it takes an argument list pointer ap of type va_list (see section A.2 Variadic Functions).

Function: int vfscanf (FILE *stream, const char *template, va_list ap)
This is the equivalent of fscanf with the variable argument list specified directly as for vscanf.

Function: int vfwscanf (FILE *stream, const wchar_t *template, va_list ap)
This is the equivalent of fwscanf with the variable argument list specified directly as for vwscanf.

Function: int vsscanf (const char *s, const char *template, va_list ap)
This is the equivalent of sscanf with the variable argument list specified directly as for vscanf.

Function: int vswscanf (const wchar_t *s, const wchar_t *template, va_list ap)
This is the equivalent of swscanf with the variable argument list specified directly as for vwscanf.

In GNU C, there is a special construct you can use to let the compiler know that a function uses a scanf-style format string. Then it can check the number and types of arguments in each call to the function, and warn you when they do not match the format string. For details, See section `Declaring Attributes of Functions' in Using GNU CC.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

  webmaster     delorie software   privacy  
  Copyright 2003   by The Free Software Foundation     Updated Jun 2003