IDS_INSERT_SDS(3)



NAME

     ids_insert_sds -  inserts an SDS to the end of the sds  list
     in IDS.



SYNOPSIS

          int ids_add_sds(IDS *ids, SDS *sds, int n);



DESCRIPTION

     Inserts the SDS to the nth position of the sdslist  in  IDS.
     If there wasn't any list, a new list is created, and the SDS
     will be the first.  Indexing starts from 1.

     Note that this copies only the  pointer,  and  NOT  the  SDS
     itself, so this function assumes that you have already allo-
     cated space for the SDS.

     The SDS should have the same dimensions as the existing SDSs
     in the list.



KEYWORDS


RETURN VALUES

     Returns -1 on error, 0 otherwise.



EXAMPLES

          IDS *my_ids;
          SDS *one_more_sds;
              .
              .
              .
          one_more_sds = sds_get_one_fits("xxx.fits");
          middle = ids_length(my_ids)/2;
          status = ids_insert_sds(my_ids, one_more_sds, middle);



SEE ALSO

     ids_delete_sds, ids_add_sds


WARNINGS

     This function doesn't check that the dimensions of  the  new
     SDS agree with the existing SDSs.



FILES


BUGS

     None


RESTRICTIONS

     None


PLANNED IMPROVEMENTS

     None


REFERENCES

     None


VERSION

     1994-02-24     Lup Ng    SOI Version 0.8