show

Purpose

Displays the global symbol table.

Format

show -flags symbol;
show -flags;
show symbol;
show;

Parameters

flags:

flags to specify the symbol type that is shown

k keywords
p procedures
f fn functions
m matrices
s strings
g show only symbols with global references
l show only symbols with all local references
symbol:

the name of the symbol to be shown. If the last character is an asterisk (*), all symbols beginning with the supplied characters will be shown.

Examples

show -fpg eig*;

This command will show all functions and procedures that have global references and begin with eig.

show -m;

This command will show all matrices.

Remarks

If there are no arguments, the entire symbol table will be displayed.

show is directed to the auxiliary output if it is open.

Here is an example listing with an explanation of the columns. Note that show does not display the column titles shown here:

Memory used Name Cplx Type References Info
128 bytes a MATRIX 4,4
672 bytes add KEYWORD global refs 0=1
192 bytes area FUNCTION local refs 1=1
256 bytes c C MATRIX 4,4
296 bytes p1 PROCEDURE local refs 1=1
384 bytes p2 PROCEDURE global refs 0=1
8 bytes ps1 STRUCT sdat *
16 bytes s STRING 8 char
312 bytes s1 STRUCT sdat 1,1
40 bytes sa STRING ARRAY 3,1
56 bytes sm SPARSE MATRIX 15,15
2104 bytes token PROCEDURE local refs 2=1
216 bytes y ARRAY 3 dims 2,3,4
672 bytes program space used
12 global symbols, 2000 maximum, 12 shown
0 active locals, 2000 maximum
1 active structure

The Memory used column gives the amount of memory used by each item.

The Name column gives the name of each symbol.

The Cplx column contains a C if the symbol is a complex matrix.

The Type column specifies the type of the symbol. It can be ARRAY, FUNCTION, KEYWORD, MATRIX, PROCEDURE, STRING, STRING ARRAY, or STRUCT.

If the symbol is a procedure, keyword or function, the References column will show if it makes any global references. If it makes only local references, the procedure or function can be saved to disk in an .fcg file with the save command. If the function or procedure makes any global references, it cannot be saved in an .fcg file.

If the symbol is a structure, the References column will contain the structure type. A structure pointer is indicated by a * following the structure type.

The Info column depends on the type of the symbol. If the symbol is a procedure or a function, it gives the number of values that the function or procedure returns and the number of arguments that need to be passed to it when it is called. If the symbol is a matrix, sparse matrix, string array or array of structures, then the Info column gives the number of rows and columns. If the symbol is a string, then it gives the number of characters in the string. If the symbol is an N-dimensional array, then it gives the orders of each dimension. As follows:

Rets=Args if procedure, keyword, or function
Row,Col if matrix, sparse matrix, string array, or structure
Length if string
OrdN,…,Ord2,Ord1 if array, where \(N\) is the slowest moving dimension of the array, and Ord is the order (or size) of a dimension

If the symbol is an array of structures, the Info column will display the size of the array. A scalar structure instance is treated as a 1x1 array of structures. If the symbol is a structure pointer, the Info column will be blank.

The program space is the area of space reserved for all nonprocedure, nonfunction program code. The maximum program space can be controlled by the new command.

The maximum number of global and local symbols is controlled by the maxglobals and maxlocals configuration variables in gauss.cfg.

See also

Functions new, delete