cdds_lseek8 - seek (8 byte precision) position within DDS binary stream

SYNOPSIS

#include "cdds.h"

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

BIN_TAG bin
FIELD_TAG tag
long long offset
int whence

[ Arguments | Output | Examples ]

DESCRIPTION

This function seeks a new position in a binary stream.
Pipe media only supports forward seeks.

ARGUMENTS

"bin" is a BIN_TAG, previously obtained from cddx_in. It specifies the binary stream on which to seek.

"tag" is a field tag which specifies a type of object offset refers to. E.g. DDS_FLOAT should be used if offset is measured in sizeof(float) words.
When tag = 0, the nominal DDS target type (which is a trace) is used.

"offset" is a position measured relative to the whence origin. The offset should be an integer number of tag types. 

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 10000000 target types (traces) */
   cdds_lseek8(bin, 0, +10000000L, SEEK_CUR);

AUTHOR

R. L. Selzler, EPTG (Oct 1995) i