void removi_c ( SpiceInt item,
SpiceCell * set )
Remove an item from an integer set.
VARIABLE I/O DESCRIPTION
-------- --- --------------------------------------------------
item I Item to be removed.
set I/O Removal set.
item is an item which is to be removed from the specified
set. item may or may not already be an element of the
set is a CSPICE set. set must be declared as an integer
On input, set may or may not contain the input item
as an element.
set on output contains the difference of the input set and
the input item. If the item is not an element of the
set, the set is not changed.
1) If the input set argument is a SpiceCell of type other than
integer, the error SPICE(TYPEMISMATCH) is signaled.
2) If the input set argument does not qualify as a CSPICE set,
the error SPICE(NOTASET) will be signaled. CSPICE sets have
their data elements sorted in increasing order and contain
no duplicate data elements.
1) In the following example, the NAIF ID code of Pluto is removed from
the integer set planets and inserted into the integer set
Declare the sets with maximum number of elements MAXSIZ.
SPICEINT_CELL ( planets, MAXSIZ );
SPICEINT_CELL ( asteroids, MAXSIZ );
removi_c ( 999, &planets );
insrti_c ( 999, &asteroids );
If 999 is not an element of planets, then the contents of planets
are not changed. Similarly, if 999 is already an element of
asteroids, the contents of asteroids remain unchanged.
N.J. Bachman (JPL)
C.A. Curzon (JPL)
W.L. Taber (JPL)
I.M. Underwood (JPL)
-CSPICE Version 1.0.0, 07-AUG-2002 (NJB) (CAC) (WLT) (IMU)
remove an item from an integer set