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 {.*})