Cascade Historian: Version 4.1
Prev |  | Next

# earliest

earliest -- gives the earliest value in a history.

## Syntax

    (earliest history)

## Parameters

`history`

  The name of a history defined by the history command.

## Returns

The value and the system time in the following format:

        (earliest history data seconds)

if successful, where `data` and `seconds` are real values. Otherwise

        (error "No data for point history")
        (error "History history does not exist")

## Description

This command returns the value for the first data item in the history. This item may be either in a file or in memory.

This command corresponds to the Cogent API function `HI_Earliest` and the `hist_earliest` dynamic library function.

## Example

        [sh]$ lsend Hist
        Hist> (earliest p1)
        (earliest p1 135.4 973631436.467178)
        Hist>

Prev | Home | Next
disable | Up | enable

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.