count

count — counts the number of histories that match a pattern.

Syntax

(count [pattern])
    

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.

Returns

The number of histories (n) that match the specified pattern, in this format:

(count pattern n)

Description

This command queries the Cascade Historian for the total number of histories currently being kept that match the given pattern.

This command corresponds to the Cogent C API function HI_Count and the hist_count dynamic library function.

Example

[sh]$ lsend Hist
Hist> (count p*)
(count p* 5)
Hist>