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