SDS_SET_DIM(3)



NAME

     sds_set_rank sds_set_length sds_set_dim

     -a set of functions to set the dimension information


SYNOPSIS

     #include <soi_sds.h>

     int sds_set_rank(SDS *sdsptr, int length)
     int sds_set_length(SDS *sdsptr, int *length)
     int sds_set_dim(SDS *sdsptr, int dim, int dimvalue)



DESCRIPTION

     returns an error status,  zero  if  all  is  well,  or  some
     appropriate error number otherwise.

     sds_set_rank sets the rank (number of  dimensions)  into  an
     SDS structure.  It mallocs a length array with rank entries.
     If a length array already exists - it frees it and sets  the
     new uninitialized length array into the structures.

     sds_set_length sets the array with the lengths of the dimen-
     sion  axes  into an SDS structure.  It is presummed that the
     array has been malloc'ed and filled prior  to  the  function
     call.

     sds_set_dim sets the dimension axis indexed by dim with  the
     value  dimvalue  where  dim  varies  from 0 to rank-1. It is
     presummed that the sds dimension array exists  and  rank  is
     valid.



FILES

     ~soi/(release)/include/soi_sds.h
     ~soi/(release)/include/soi_error.h
     ~soi/(release)/src/libsds.d/sds_set.c



SEE ALSO

     sds_set_length, sds_set_rank sds_set_dim



HISTORY

     93.10.12 K Scott:  created this file for SOI V.0.7
     94.02.08 katie     added sds_set_dim();
     94.02.08 L. Bacon  SOI Version 0.8