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);
}
...
}