The dump command provides a way for the user to
spit out state information about the interpreter in a Tcl readable
(and human readable) form. It takes the general form:
dump method ?-nocomplain?
?-filter pattern? ?--? pattern ?pattern ...?
The patterns represent glob-style patterns (as in
string
match pattern $str).
-nocomplain will prevent
dump from throwing an error if no items matched the
pattern.
-filter is interpreted as appropriate for the
method. The various methods are:
dump command args
- Outputs one or more commands.
dump procedure args
- Outputs one or more procs in sourceable form.
dump variable args
- Outputs the values of variables in sourceable form. Recognizes
nested arrays. The -filter pattern is used as to filter
array element names and is interepreted as a glob pattern (defaults
to {*}). It is passed down for nested arrays.
dump widget args
- Outputs one or more widgets by giving their configuration
options. The -filter pattern is used as to filter the config
options and is interpreted as a case insensitive regexp pattern
(defaults to {.*})