- Abstract
Remove an item from an integer set.
- Required_Reading
SETS
- Brief_I/O
VARIABLE I/O DESCRIPTION
-------- --- --------------------------------------------------
item I Item to be removed.
set I/O Removal set.
- Detailed_Input
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.
set is a CSPICE set. set must be declared as an integer
SpiceCell.
On input, set may or may not contain the input item
as an element.
- Detailed_Output
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.
- Parameters
None.
- Particulars
None.
- Examples
1) In the following example, the NAIF ID code of Pluto is removed from
the integer set planets and inserted into the integer set
asteroids.
#include "SpiceUsr.h"
.
.
.
/.
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.
- Restrictions
None.
- Exceptions
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.
- Files
None.
- Author_and_Institution
N.J. Bachman (JPL)
C.A. Curzon (JPL)
W.L. Taber (JPL)
I.M. Underwood (JPL)
- Literature_References
None.
- Version
-CSPICE Version 1.0.0, 07-AUG-2002 (NJB) (CAC) (WLT) (IMU)
- Index_Entries
remove an item from an integer set
- Link to routine source