Index of Functions: A B C D E F G H I J K L M N O P Q R S T U V W X
Index Page dasudi_c
Table of contents
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
       dasudi_c ( DAS, update data, integer )

       void dasudi_c ( SpiceInt            handle,
                       SpiceInt            first,
                       SpiceInt            last,
                       ConstSpiceInt       data   [] )
#### Abstract
       Update data in a specified range of integer addresses in a DAS
       file.
#### Required_Reading
       DAS
#### Keywords
       ARRAY
       ASSIGNMENT
       DAS
       FILES
#### Brief_I/O
       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       handle     I   DAS file handle.
       first,
       last       I   Range of integer addresses to write to.
       data       I   An array of integers.
#### Detailed_Input
       handle      is a file handle of a DAS file opened for writing.

       first,
       last        are the first and last of a range of DAS logical
                   addresses of integers to update. These addresses satisfy
                   the inequality

                      1  <=   first   <=   last   <=   lasti

                   where `lasti' is the last integer logical address in
                   use in the DAS file designated by `handle'.

       data        is an array of integers. The array elements
                   data[0] through data[n-1] will be written to the
                   indicated DAS file, where `n' is last - first + 1.
#### Detailed_Output
       None.

       See -Particulars for a description of the effect of this routine.
#### Parameters
       None.
#### Exceptions
       1)  If the input file handle is invalid, an error is
           signaled by a routine in the call tree of this routine.

       2)  Only logical addresses that already contain data may be
           updated: if either `first' or `last' are outside the range

              [ 1,  lasti ]

           where `lasti' is the last integer logical address that currently
           contains data in the indicated DAS file, the error
           SPICE(INVALIDADDRESS) is signaled by a routine in the call tree of
           this routine. The DAS file will not be modified.

       3)  If first > last but both addresses are valid, this routine
           will not modify the indicated DAS file. No error will be
           signaled.

       4)  If an I/O error occurs during the data update attempted
           by this routine, the error is signaled by a routine in the
           call tree of this routine.
#### Files
       See the description of the argument `handle' in -Detailed_Input.
#### Particulars
       This routine replaces the integer data in the specified range of
       logical addresses within a DAS file with the contents of the
       input array `data'.

       The actual physical write operations that update the indicated
       DAS file with the contents of the input array `data' might not take
       place before this routine returns, since the DAS system buffers
       data that is written as well as data that is read. In any case,
       the data will be flushed to the file at the time the file is
       closed, if not earlier. A physical write of all buffered
       records can be forced by calling the CSPICE routine daswbr_c
       (DAS, write buffered records).

       In order to append integer data to a DAS file, filling in a range
       of integer logical addresses that starts immediately after the
       last integer logical address currently in use, the CSPICE
       routine dasadi_c (DAS add data, integer) should be used.
#### Examples
       The numerical results shown for this example may differ across
       platforms. The results depend on the SPICE kernels used as
       input, the compiler and supporting libraries, and the machine
       specific arithmetic implementation.

       1) Write to addresses 1 through 200 in a DAS file in random-access
          fashion by updating the file. Recall that data must be present
          in the file before it can be updated.

          Example code begins here.

          /.
             Program dasudi_ex1
          ./
          #include <stdio.h>
          #include "SpiceUsr.h"

          int main( )
          {

             /.
             Local parameters.
             ./
             #define FNAME        "dasudi_ex1.das"
             #define TYPE         "TEST"

             /.
             Local variables.
             ./
             SpiceInt             data   [200];

             SpiceInt             handle;
             SpiceInt             i;
             SpiceInt             j;

             /.
             Open a new DAS file. Use the file name as the internal
             file name, and reserve no records for comments.
             ./
             dasonw_c ( FNAME, TYPE, FNAME, 0, &handle );

             /.
             Append 200 integers to the file; after the data are
             present, we're free to update it in any order we
             please.  (cleari_c zeros out an integer array.)
             ./
             cleari_c ( 200, data );
             dasadi_c ( handle, 200, data );

             /.
             Now the integer logical addresses 1:200 can be
             written to in random-access fashion.  We'll fill them
             in reverse order.
             ./
             for ( i = 200; i >= 1; i -= 1 )
             {
                dasudi_c ( handle, i, i, &i );
             }

             /.
             Close the file.
             ./
             dascls_c ( handle );

             /.
             Now make sure that we updated the file properly.
             Open the file for reading and dump the contents
             of the integer logical addresses 1:200.
             ./
             dasopr_c ( FNAME, &handle );

             cleari_c ( 200, data );
             dasrdi_c ( handle, 1, 200, data );

             printf( "\n" );
             printf( "Data from \"%s\":\n", FNAME );
             printf( "\n" );
             for ( i = 0; i < 20; i++ )
             {
                for ( j = 0; j < 10; j++ )
                {
                   printf( "%5d", data[i*10+j] );
                }
                printf( "\n" );
             }

             /.
             Close the file.
             ./
             dascls_c ( handle );

             return ( 0 );
          }

          When this program was executed on a Mac/Intel/cc/64-bit
          platform, the output was:

          Data from "dasudi_ex1.das":

              1    2    3    4    5    6    7    8    9   10
             11   12   13   14   15   16   17   18   19   20
             21   22   23   24   25   26   27   28   29   30
             31   32   33   34   35   36   37   38   39   40
             41   42   43   44   45   46   47   48   49   50
             51   52   53   54   55   56   57   58   59   60
             61   62   63   64   65   66   67   68   69   70
             71   72   73   74   75   76   77   78   79   80
             81   82   83   84   85   86   87   88   89   90
             91   92   93   94   95   96   97   98   99  100
            101  102  103  104  105  106  107  108  109  110
            111  112  113  114  115  116  117  118  119  120
            121  122  123  124  125  126  127  128  129  130
            131  132  133  134  135  136  137  138  139  140
            141  142  143  144  145  146  147  148  149  150
            151  152  153  154  155  156  157  158  159  160
            161  162  163  164  165  166  167  168  169  170
            171  172  173  174  175  176  177  178  179  180
            181  182  183  184  185  186  187  188  189  190
            191  192  193  194  195  196  197  198  199  200

          Note that after run completion, a new DAS file exists in the
          output directory.
#### Restrictions
       None.
#### Literature_References
       None.
#### Author_and_Institution
       J. Diaz del Rio     (ODC Space)
#### Version
       -CSPICE Version 1.0.0, 16-JUL-2021 (JDR)
#### Index_Entries
       update integer data in a DAS file
#### Link to routine dasudi_c source file dasudi_c.c

    Fri Dec 31 18:41:04 2021