---

7.6 Programmatic Interface

The user interface for access to the argument information is completely defined in the generated header file and in the portions of the distributed file "options.h" that are marked "public".

In the following macros, text marked <NAME> or name is the name of the option in upper case and segmented with underscores _. The macros and enumerations defined in the options header (interface) file are used as follows:

To see how these #define macros are used in a program, the reader is referred to the several opts.h files included with the AutoGen sources.

• Data for Option Processing
• CLEAR_OPT( <NAME> ) - Clear Option Markings
• COUNT_OPT( <NAME> ) - Definition Count
• DESC( <NAME> ) - Option Descriptor
• DISABLE_OPT_name - Disable an option
• ENABLED_OPT( <NAME> ) - Is Option Enabled?
• ERRSKIP_OPTERR - Ignore Option Errors
• ERRSTOP_OPTERR - Stop on Errors
• HAVE_OPT( <NAME> ) - Have this option?
• ISSEL_OPT( <NAME> ) - Is Option Selected?
• ISUNUSED_OPT( <NAME> ) - Never Specified?
• OPTION_CT - Full Count of Options
• OPT_ARG( <NAME> ) - Option Argument String
• OPT_NO_XLAT_CFG_NAMES - option name xlation
• OPT_NO_XLAT_OPT_NAMES - option name xlation
• OPT_VALUE_name - Option Argument Value
• OPT_XLAT_CFG_NAMES - option name xlation
• OPT_XLAT_OPT_NAMES - option name xlation
• RESTART_OPT( n ) - Resume Option Processing
• SET_OPT_name - Force an option to be set
• STACKCT_OPT( <NAME> ) - Stacked Arg Count
• STACKLST_OPT( <NAME> ) - Argument Stack
• START_OPT - Restart Option Processing
• STATE_OPT( <NAME> ) - Option State
• USAGE( exit-code ) - Usage invocation macro
• VALUE_OPT_name - Option Flag Value
• VERSION - Version and Full Version
• WHICH_IDX_name - Which Equivalenced Index
• WHICH_OPT_name - Which Equivalenced Option
• teOptIndex - Option Index and Enumeration
• OPTIONS_STRUCT_VERSION - active version
• libopts External Procedures