LG_Fall

LG_Fall — associates values logged within a tolerance.

Syntax

#include <cogent.h>
ST_STATUS LG_Fall(IP_Task*  myself,
 IP_Task*  textlog,
 char*  retbuf,
 int  buflen,
 char*  direction,
 int  nlabels,
 char**  labels);

Arguments

myself

A pointer to this task's IP_Task structure normallly generated by a call to IP_NserveInit.

textlog

A pointer to the Cascade TextLogger's IP_Task structure, normally generated by a call to IP_TaskFindName.

retbuf

A pointer to a character buffer to hold the return from the call.

buflen

The length of retbuf, in bytes.

direction

One of the following:

forward

Associates a new value with the next logged value.

backward

Associates a new value with the previously logged value.

closest

Associates a new value with the value nearest in time.

nlabels

The number of labels (log or group names) referenced in the labels argument.

labels

An array of char*, each of which is a pointer to a string containing a log or group name.

Returns

ST_OK on success. Otherwise ST_ERROR, and the retbuf will contain a more detailed error message (see fall in the Cascade TextLogger documentation). If the return value is ST_OK, the retbuf may not contain useful information.

Description

This function determines how the Cascade TextLogger will associate different values logged within a given tolerance. It corresponds to the Cascade TextLogger fall command. Please refer to that document for an example.