|The PLplot Plotting Library: Programmer's Reference Manual|
|Prev||Chapter 19. The Common API for PLplot||Next|
Parse command-line arguments.
plparseopts removes all recognized flags
(decreasing argc accordingly), so that invalid input may be readily
detected. It can also be used to process user command line flags. The
user can merge an option table of type PLOptionTable into the internal
option table info structure using
plMergeOpts. Or, the user can
specify that ONLY the external table(s) be parsed by calling
The default action taken by
plparseopts is as follows:
|Returns with an error if an unrecognized option or badly formed option-value pair are encountered.|
|Returns immediately (return code 0) when the first non-option command line argument is found.|
|Returns with the return code of the option handler, if one was called.|
|Deletes command line arguments from argv list as they are found, and decrements argc accordingly.|
|Does not show "invisible" options in usage or help messages.|
|Assumes the program name is contained in argv.|
These behaviors may be controlled through the
Perl/PDL: Not available?
This function is used in all of the examples.