Manual Pages for UNIX Darwin command on man cmdline

cmdline(n) command line / option processing cmdline(n)

NAME

cmdline - Procedures to process command lines and options.

SYNOPSIS

package require TTccll 88..22 package require ccmmddlliinnee ??11..22..22?? ::::ccmmddlliinnee::::ggeettoopptt argvVar optstring optVar valVar ::::ccmmddlliinnee::::ggeettKKnnoowwnnOOpptt argvVar optstring optVar valVar ::::ccmmddlliinnee::::ggeettooppttiioonnss arglistVar optlist ?usage?

::cmdline::getKnownOptions rlsVr pls ?sg?

::::ccmmddlliinnee::::uussaaggee optlist ?usage? ::::ccmmddlliinnee::::ggeettffiilleess patterns quiet ::::ccmmddlliinnee::::ggeettAArrggvv00

DESCRIPTION

This package provides commands to parse command lines and options. ::::ccmmddlliinnee::::ggeettoopptt argvVar optstring optVar valVar This command works in a fashion like the standard C based ggeettoopptt function. Given an option string and a pointer to an array or args this command will process the first argument and return info on how to proceed. The command returns 1 if an option was

found, 0 if no more options were found, and -1 if an error

occurred. argvVar contains the name of the argv list to process. If options are found the arg list is modified and the processed arguments are removed from the start of the list.

optstring contains a list of command options that the applica-

tion will accept. If the option ends in ".arg" the command will use the next argument as an argument to the option. Otherwise the option is a boolean that is set to 1 if present. optVar refers to the variable the command will store the found

option into (without the leading '-' and without the .arg exten-

sion). valVar refers to the variable to store either the value for the specified option into upon success or an error message in the case of failure. The stored value comes from the command line for .arg options, otherwise the value is 1. ::::ccmmddlliinnee::::ggeettKKnnoowwnnOOpptt argvVar optstring optVar valVar Like ::::ccmmddlliinnee::::ggeettoopptt, but ignores any unknown options in the input. ::::ccmmddlliinnee::::ggeettooppttiioonnss arglistVar optlist ?usage? Processes the set of command line options found in the list variable named by arglistVar and fills in defaults for those not specified. This also generates an error message that lists the allowed flags if an incorrect flag is specified. The optional

usage-argument contains a string to include in front of the gen-

erated message. If not present it defaults to "options:". optlist contains a list of lists where each element specifies an option in the form: flag default comment. If flag ends in ".arg" then the value is taken from the command line. Otherwise it is a boolean and appears in the result if present on the command line. If flag ends in ".secret", it will not be displayed in the usage.

::cmdline::getKnownOptions rlsVr pls ?sg?

Like ::::ccmmddlliinnee::::ggeettooppttiioonnss, but ignores any unknown options in the input. ::::ccmmddlliinnee::::uussaaggee optlist ?usage? Generates and returns an error message that lists the allowed flags. optlist is defined as for ::::ccmmddlliinnee::::ggeettooppttiioonnss. The

optional usage-argument contains a string to include in front of

the generated message. If not present it defaults to "options:". ::::ccmmddlliinnee::::ggeettffiilleess patterns quiet Given a list of file patterns this command computes the set of valid files. On windows, file globbing is performed on each argument. On Unix, only file existence is tested. If a file

argument produces no valid files, a warning is optionally gener-

ated (set quiet to true). This code also uses the full path for each file. If not given it prepends the current working directory to the filename. This ensures that these files will never conflict with files in a

wrapped zip file. The last sentence refers to the pro-tools.

::::ccmmddlliinnee::::ggeettAArrggvv00 This command returns the "sanitized" version of argv0. It will strip off the leading path and removes the ".bin" extensions

that the pro-apps use because they must be wrapped by a shell

script. EEXXAAMMPPLLEESS set options { {a "set the atime only"} {m "set the mtime only"}

{c "do not create non-existant files"}

{r.arg "" "use time from reffile"}

{t.arg -1 "use specified time"}

} set usage ": MyCommandName \[options] filename ...\noptions:"

array set params [::cmdline::getoptions argv $options $usage]

if { $params(a) } { set setatime "true" }

set hast [expr {$params(t) != -1}]

set hasr [expr {[string length $params(r)] > 0}]

if {$hast && $hasr} {

return -code error "Cannot specify both -r and -t"

} elseif {$hast} {

... } This example, taken (and slightly modified) from the fileutil package,

shows how to use cmdline. First, a list of options is created, then

the 'args' list is passed to cmdline for processing. Subsequently,

different options are checked to see if they have been passed to the script, and what their value is. KKEEYYWWOORRDDSS