appndd_c

Index Page appndd_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 appndd_c ( SpiceDouble     item,
                       SpiceCell     * cell )
#### Abstract
       Append an item to a double precision 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 double precision value which is to be appended to
                  cell.

       cell       is a double precision 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 double precision 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 double precision 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.0
                Element 1: == 1.0
                Element 2: == 2.0
                Element 3: == 3.0
                Element 4: == 5.0
                Element 5: == 8.0
                Element 6: == 13.0
                Element 7: == 21.0

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

             appndd_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 a d.p. cell
#### Link to routine appndd_c source file appndd_c.c

    Thu Apr 16 08:57:20 2009