Index Page removi_c

A B C D E F G H I J K L M N O P Q R S T U V W X

Procedure Abstract Required_Reading Keywords Brief_I/O Detailed_Input | Detailed_Output Parameters Exceptions Files Particulars Examples | Restrictions Literature_References Author_and_Institution Version Index_Entries

#### Procedure

       void removi_c ( SpiceInt        item,
                       SpiceCell     * set  )

#### Abstract

       Remove an item from an integer set.

#### Required_Reading

       SETS

#### Keywords

       CELLS, 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.

#### 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.

#### 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.

#### Literature_References

       None.

#### Author_and_Institution

       N.J. Bachman    (JPL)
       C.A. Curzon     (JPL)
       W.L. Taber      (JPL)
       I.M. Underwood  (JPL)

#### 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 removi_c source file removi_c.c

    Wed Apr  5 17:54:41 2017