| [Overview][Types][Classes][Variables][Index] | 
Check whether all given options on the command-line are valid.
Source position: custapp.pp line 65
| public function TCustomApplication.CheckOptions( | 
| const ShortOptions: string; | 
| const Longopts: TStrings; | 
| Opts: TStrings; | 
| NonOpts: TStrings; | 
| AllErrors: Boolean = False | 
| ):string; | 
| const ShortOptions: string; | 
| const Longopts: array of string; | 
| Opts: TStrings; | 
| NonOpts: TStrings; | 
| AllErrors: Boolean = False | 
| ):string; | 
| const ShortOptions: string; | 
| const Longopts: TStrings; | 
| AllErrors: Boolean = False | 
| ):string; | 
| const ShortOptions: string; | 
| const LongOpts: array of string; | 
| AllErrors: Boolean = False | 
| ):string; | 
| const ShortOptions: string; | 
| const LongOpts: string; | 
| AllErrors: Boolean = False | 
| ):string; | 
| ShortOptions | 
 | List of valid short options. | 
| Longopts | 
 | List of valid long options. | 
| Opts | 
 | Valid options passed to the program. | 
| NonOpts | 
 | Non-option strings passed to the program. | 
| AllErrors | 
 | Should all errors be returned, or just the first one? | 
Empty string or error-message
| ShortOptions | 
 | List of valid short options. | 
| Longopts | 
 | List of valid long options. | 
| Opts | 
 | Valid options passed to the program. | 
| NonOpts | 
 | Non-option strings passed to the program. | 
| AllErrors | 
 | Should all errors be returned, or just the first one? | 
| ShortOptions | 
 | List of valid short options. | 
| Longopts | 
 | List of valid long options. | 
| AllErrors | 
 | Should all errors be returned, or just the first one? | 
| ShortOptions | 
 | List of valid short options. | 
| LongOpts | 
 | List of valid long options. | 
| AllErrors | 
 | Should all errors be returned, or just the first one? | 
| ShortOptions | 
 | List of valid short options. | 
| LongOpts | 
 | List of valid long options. | 
| AllErrors | 
 | Should all errors be returned, or just the first one? | 
CheckOptions scans the command-line and checks whether the options given are valid options. It also checks whether options that require a valued are indeed specified with a value.
The ShortOptions contains a string with valid short option characters. Each character in the string is a valid option character. If a character is followed by a colon (:), then a value must be specified. If it is followed by 2 colon characters (::) then the value is optional.
LongOpts is a list of strings (which can be specified as an array, a TStrings instance or a string with whitespace-separated values) of valid long options.
When the function returns, if Opts is non-Nil, the Opts stringlist is filled with the passed valid options. If NonOpts is non-nil, it is filled with any non-option strings that were passed on the command-line.
The function returns an empty string if all specified options were valid options, and whether options requiring a value have a value. If an error was found during the check, the return value is a string describing the error.
Options are identified as command-line parameters which start with OptionChar (by default the dash ('-') character).
if AllErrors is True then all errors are returned, separated by a sLineBreak character.
If an error was found during the check, the return value is a string describing the error(s).
| 
 | Return the index of an option. | |
| 
 | Return the value of a command-line option. | |
| 
 | Check whether an option was specified. | |
| 
 | Are options interpreted case sensitive or not | |
| 
 | Command-line switch character |