Navigation

Operators and Keywords

Function List:

C++ API

: val = whos_line_format ()
: old_val = whos_line_format (new_val)
: whos_line_format (new_val, "local")

Query or set the format string used by the command whos.

A full format string is: 

%[modifier]<command>[:width[:left-min[:balance]]];

The following command sequences are available:

%a

Prints attributes of variables (g=global, p=persistent, f=formal parameter, a=automatic variable).

%b

Prints number of bytes occupied by variables.

%c

Prints class names of variables.

%e

Prints elements held by variables.

%n

Prints variable names.

%s

Prints dimensions of variables.

%t

Prints type names of variables.

Every command may also have an alignment modifier:

l

Left alignment.

r

Right alignment (default).

c

Column-aligned (only applicable to command %s).

The width parameter is a positive integer specifying the minimum number of columns used for printing. No maximum is needed as the field will auto-expand as required.

The parameters left-min and balance are only available when the column-aligned modifier is used with the command ‘%s’. balance specifies the column number within the field width which will be aligned between entries. Numbering starts from 0 which indicates the leftmost column. left-min specifies the minimum field width to the left of the specified balance column.

The default format is:

" %a:4; %ln:6; %cs:16:6:1; %rb:12; %lc:-1;\n"

When called from inside a function with the "local" option, the variable is changed locally for the function and any subroutines it calls. The original variable value is restored when exiting the function.

See also: whos.

Package: octave