cddx_readall - read an entire DDS dataset

SYNOPSIS

#include "cdds.h"

int function cddx_readall(alias, bufptr, rank, size, delta, origin);

const char *alias
void **bufptr
int *rank
int size[RANK_MAX]
float delta[RANK_MAX]
float origin[RANK_MAX]

DESCRIPTION

Routine, "cddx_readall", opens and reads an entire dataset as indicated by "alias". The size of the dataset is determined by the rank and size array. The memory is allocated, filled and the pointer is returned into "bufptr". To release the memory use "cdds_free" on the "bufptr". The data "rank", "size", "delta" and "origin" are returned. The "size", "delta" and "origin" arrays must be defined with length of RANK_MAX. All values beyond the actual dataset rank are set to 1, 1.0 and 0.0 respectively. If the memory cannot be allocated then a DDS panic error will occur; if the dataset is unable to be opened then it will return -1; if the dataset is not specified (as referenced by the "alias" name) the return value is -2; if it is unable to read all the expected traces then the return value is -3; otherwise the bin_tag is returned and the dataset is kept open so that the bin_tag could be used to open an output dataset.

AUTHOR

Jerry Ehlers, BP America (May 2003)