Cascade Historian™ : Version 5.4
	Commands

`list`

list — finds the name of available histories.

Syntax

(list [pattern [offset [count]]])

Parameters

pattern: The name of one or more (using a globbing pattern) histories previously defined by the history command. When this parameter is not specified, the default is *, to include all histories.
offset: An integer specifying a starting point in the list generated by pattern. When this parameter is not specified, the default is 0, to start at the beginning of the list.
count: An integer specifying an end point in the list generated by pattern. When this parameter is not specified, the default is the maximum number of names (corresponding to the number of the last name in the list).

Returns

A list of the history names matching the pattern, in the following format:

(list pattern history₁ history₂ ... )

Description

This command finds the names of specified histories. The offset and count parameters optionally permit only reporting a portion of the list generated by pattern. This is useful where the history names are many and/or long, because the limited size of the message buffer (typically 4K) could result in truncation of the list.

This command corresponds to the Cogent C API function HI_List and the hist_list dynamic library function.

Example

[sh]$ lsend Hist
Hist> (list p*)
(list p* p1 p2 p3 p4 p5 p6 p7 p8 p9)
[sh]$ lsend Hist
Hist> (list p* 5 2)
(list p* p6 p7)
Hist>


length		register