cdds_read - read DDS binary data

SYNOPSIS

#include "cdds.h"

int cdds_read(bin, tag, buf, count);

BIN_TAG bin
FIELD_TAG tag
void *buf
int count

DESCRIPTION

This function reads data from a binary stream, into a buffer.

INPUT

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

tag is a field tag, previously obtained eg. from cdds_member. It specifies a tag associated with bin. This provides a scale factor for count. If tag is zero (nominal), it defaults to the SEQUENCE (trace type) associated with bin.

Data is read into buf. The minimum size is count times the size of tag.

OUTPUT

A byte sequence from the stream is copied into the buffer; no conversions are performed.

The return value is the number of types actually read, or EOF if an error occurred before any transfer.

EXAMPLES

          
            BIN_TAG in_bin;
            char *buf;
            ...
            /* read 10 traces into type buffer */
            cdds_read(in_bin, 0, buf, 10);

SEE ALSO

      cdds_readm Read binary stream & map buffer

AUTHOR

R. L. Selzler, EPTG (Dec 1994)