appndi_c

Index Page appndi_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 appndi_c ( SpiceInt        item,
                       SpiceCell     * cell )
#### Abstract
       Append an item to an integer cell.
#### Required_Reading
       CELLS
#### Keywords
       CELLS
#### Brief_I/O
       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       item       I   The item to append.
       cell      I/O  The cell to which item will be appended.
#### Detailed_Input
       item       is an integer value which is to be appended to cell.

       cell       is an integer SpiceCell to which item will be appended.
#### Detailed_Output
       cell       is the input SpiceCell with item appended.  item is the
                  last member of cell.

                  If cell is actually a CSPICE set on input and ceases to
                  qualify as a set as result of the requested append
                  operation, the isSet member of cell will be set to
                  SPICEFALSE.
#### Parameters
       None.
#### Exceptions
       1) If the input cell argument doesn't have integer data type,
          the error SPICE(TYPEMISMATCH) is signaled.

       2) If the cell is not big enough to accommodate the addition
          of a new element, the error SPICE(CELLTOOSMALL) is signaled.
#### Files
       None.
#### Particulars
       None.
#### Examples
       1)  In the following example, the element 34 is appended to
           the integer cell fibNums.

             #include "SpiceUsr.h"
                    .
                    .
                    .
             /.
             Declare the cell with maximum number of elements MAXSIZ.
             ./
             SPICEINT_CELL ( fibNums, MAXSIZ );
                    .
                    .
                    .
             /.
             Before appending 34, the cell contains:

                Element 0: == 1
                Element 1: == 1
                Element 2: == 2
                Element 3: == 3
                Element 4: == 5
                Element 5: == 8
                Element 6: == 13
                Element 7: == 21

             The following call appends the element 34 at index 8, and
             updates the cardinality.
             ./

             appndi_c ( 34, &fibNums );
#### Restrictions
       None.
#### Literature_References
       None.
#### Author_and_Institution
       N.J. Bachman    (JPL)
       H.A. Neilan     (JPL)
#### Version
       -CSPICE Version 1.0.0, 01-AUG-2002 (NJB) (HAN)
#### Index_Entries
       append an item to an integer cell
#### Link to routine appndi_c source file appndi_c.c

    Thu Apr 16 08:57:21 2009