VMS Help CC, Run-time functions, fscanf  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  Performs formatted input from a specified file.

  Syntax:

       #include <stdio.h>

       fscanf(FILE *file_pointer, const char *format_string,...);

  The ...  represents optional expressions that are pointers to
  objects whose results correspond to conversion specifications given
  in the format_string.  If no conversion specifications are given,
  you can omit the input pointers.  Otherwise, the function calls
  must have exactly as many input pointers as there are conversion
  specifications, and the conversion specifications must match the
  types of the input pointers.  Conversion specifications are matched
  to input sources in left-to-right order.

  The format_string for the input of information can include three
  kinds of items:

   o  White-space characters (spaces, tabs, and new-line characters),
      which match optional white-space characters in the input field.

   o  Ordinary characters (not %), which must match the next
      nonwhite-space character in the input.

   o  Conversion specifications, which govern the conversion of the
      characters in an input field and their assignment to an object
      indicated by a corresponding input pointer.

 A conversion specification consists of the following characters, in
 the order listed:

       o  A percent character (%) or the sequence %n$ (where n is an
          integer).

          The sequence %n$ denotes that the conversion is applied to
          the nth input pointer listed, where n is a decimal integer
          between [1, NL_ARGMAX] (see the <limits.h> header file).
          For example, a conversion specification beginning %5$ means
          that the conversion will be applied to the 5th input
          pointer listed after the format specification.  The
          sequence %$ is invalid.  If the conversion specification
          does not begin with the sequence %n$ the conversion
          specification is matched to its input pointer in
          left-to-right order.  You should only use one type of
          conversion specification (% or %n$) in a format
          specification.

       o  One or more optional characters

       o  A conversion specifier.

  Additional Information (explode) :

• Optional character
• Conversion Specifier