Header:       xscanf.h

Purpose:      Includes code for reading entries from GIPSY SETUP files.

Category:     MANAGEMENT

File:         xscanf.h

Author:       K.G. Begeman

Use:          int xscanf( FILE *setup_file, const char *format, ... )

              xscanf         Returns the number of record entries or
                             EOF if end of file is reached.
              setup_file     File descriptor returned by fopen.
              format         Format which describes the decoding of
                             record entries. Decoding types are:
                             strings     They are denoted by %s or %Ns,
                                         where N is an optional maximum
                                         length. Instead of N an asterix
                                         may be used, which means that the
                                         maximum string length is read from
                                         the argument list.
                                         If a maximum length is specified,
                                         it does not include the trailing
                                         zero byte.
                             integers    They are denoted by %d.
              ...            Arguments can be of type character pointer for
                             text fields, integer pointer for integer fields
                             or integer in case of length specifier.

Updates:      May  3, 1991: KGB Document created.