NAME

cdds_lseek - seek position in DDS binary stream

SYNOPSIS

#include "cdds.h"

long cdds_lseek(bin , tag, offset, whence);

BIN_TAG bin
FIELD_TAG tag
long offset
int whence

<P> [ <A HREF="#input">Input</A> | <A HREF="#output">Output</A> | <A HREF="#examples">Examples</A> ] <Hr>

DESCRIPTION

This function seeks a new position in a binary stream.

Pipe media only supports forward seeks.

INPUT

Bin is a binary tag, previously obtained from It specifies a particular binary stream.

tag is a field tag which specifies a tag associated with bin. This provides an offset relative to an absolute origin as defined by whence. If tag is zero (nominal), it defaults to the target (trace type) associated with bin.

Offset is a position, measured relative to the whence origin. The Offset should be an integral multiple of type relative to the absolute origin. tab(|); lI lB lB l. whence|seek origin. SEEK_SET|beginning of the file. SEEK_CUR|current file position. SEEK_END|end of the file.

OUTPUT

The current binary stream position may be changed.

The return value is the new offset, or -1 if an error occurred.

EXAMPLES

 BIN_TAG bin;

 ...

 /* skip next 10 target types (traces) */

 cdds_lseek(bin, 0, +10, SEEK_CUR);

SEE ALSO

} tab(|); lb l. dds(1)|End user overview cdds_api(3)|"C" Application Program Interface }

AUTHOR

R. L. Selzler, EPTG (Oct 1995) Jerry Ehlers, BP America (May 2003)