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