NAME

       VistaIOReportBadArgs - report unrecognized command line arguments

SYNOPSIS

       #include <vistaio.h>

       void VistaIOReportBadArgs (argc, argv)
              int argc;
              char *argv;

ARGUMENTS

       argc   Specifies the number of unrecognized command line arguments.

       argv   Specifies a vector of unrecognized command line arguments.

DESCRIPTION

       VistaIOReportBadArgs  is  usually called after VistaIOParseCommand has indicated a problem
       parsing command  line  arguments.  It  prints  a  message  listing  those  arguments  that
       VistaIOParseCommand could not comprehend.

       VistaIOParseCommand  leaves  the  program name and any unrecognized arguments in the first
       argc entries of the argv vector.  VistaIOReportBadArgs finds them there: it  assumes  that
       argv[0]  contains  the  program's  name,  and  that argv[1] through argv[argc - 1] are the
       arguments that could not be parsed.  The message it prints to the standard error stream is
       of the form:

              program: Unrecognized arguments: arg1 arg2 ...

       where  program  is  the  first  element  of  argv  and  arg1, arg2, etc. are the remaining
       elements.

EXAMPLES

       The following code fragment parses command line arguments using  VistaIOParseCommand.  Any
       arguments not recognized by VistaIOParseCommand are then parsed by some other means (e.g.,
       by  XtDisplayInitialize(3Xt)).   Finally,  if  any  arguments  remain,  having  not   been
       recognized  during  either  parsing,  they are printed along with information on the valid
       program options.

       #include <vistaio.h>

       static VistaIOOptionDescRec options[] = { /* option table entries */ };

       int main (int argc, char *argv)
       {
              if (! VistaIOParseCommand (VistaIONumber (options), options, & argc, argv))
                     goto Usage;

              Parse arguments remaining in argv[1] ... argv[argc - 1].

              if (argc > 1) {
                     VistaIOReportBadArgs (argc, argv);
       Usage:
                     VistaIOReportUsage (argv[0], VistaIONumber (options), options, NULL);
                     fprintf (stderr, "    plus any X Windows options.\n\n");
                     exit (1);
              }

              ...

       }

SEE ALSO

       VistaIOParseCommand(3), VistaIOReportUsage(3), VistaIOoption(3),

AUTHOR

       Art Pope <pope@cs.ubc.ca>

       Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>