| DDS Developers Documentation → Fortran Convenience → readall |
fddx_dict fddx_getbin fddx_getdict fddx_in fddx_in2 fddx_index fddx_inhdr fddx_mod fddx_mod2 fddx_out fddx_outhdr fddx_read fddx_readall fddx_readfrom fddx_rmaxis fddx_write fddx_writeto fddx_wtime |
fddx_readall - read an entire DDS datasetSYNOPSIS#include <fdds.h> (fixed-format sources)#include <f90dds.h> (free-format sources) integer function fddx_readall(alias, ptr_buf, rank, size, delta, origin)
DESCRIPTIONRoutine, "fddx_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 "ptr_buf". To release the memory use "fdds_free" on the pointer. 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.AUTHORJerry Ehlers, BP America (May 2003) |