Index Page
dascls_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 dascls_c ( SpiceInt handle ) 

Abstract

 
   Close a DAS file. 
 

Required_Reading

 
   DAS 
 

Keywords

 
   DAS 
   FILES 
 

Brief_I/O

 
   Variable  I/O  Description 
   --------  ---  -------------------------------------------------- 
   handle     I   Handle of an open DAS file. 
   FTSIZE     P   Maximum number of simultaneously open DAS files. 
 

Detailed_Input

 
   handle         is the file handle of an open DAS file. 
 

Detailed_Output

 
   None.  See $Particulars for a description of the effect of this 
   routine. 
 

Parameters

 
   FTSIZE         is the maximum number of DAS files that can be 
                  open at any one time.  See the file dasfm.c
                  for details.
 

Exceptions

 
   Error free. 
 
   1)  If `handle' is not the handle of an open DAS file, no error 
       is signaled. 
 

Files

 
   See the description of input argument `handle' in $Detailed_Input. 
 

Particulars

 
   This routine provides the primary recommended method of closing an
   open DAS file.  It is also possible to close a DAS file without
   segregating it by calling daswbr_ and dasllc_. Closing a DAS file by
   any other means may cause the DAS mechanism for keeping track of
   which files are open to fail.  Closing a DAS file that has been
   opened for writing by any other means may result in the production
   of something other than a DAS file.
 

Examples

 
   1)  Open a new DAS file called TEST.DAS, add 100 d.p. numbers 
       to it, and then close the file. 
 
          #include "SpiceUsr.h"
          #include "SpiceZfc.h"
          #include <string.h>

          int main()
          {
             #define  NMAX           100 

             SpiceChar             * fname;
             SpiceChar             * ftype;
             SpiceChar             * ifname;

             SpiceDouble             ddata  [ NMAX ];

             SpiceInt                handle;
             SpiceInt                i;
             SpiceInt                n;
             SpiceInt                ncomch;


             /.
             We'll give the file the same internal file name
             as the file's actual name.  We don't require any
             comment records.
             ./
             fname  = "TEST.DAS";
             ftype  = "TEST";
             ifname = fname;
             ncomch = 0;

             dasonw_ ( (SpiceChar *) fname,
                       (SpiceChar *) ftype,
                       (SpiceChar *) ifname,
                       (integer   *) &ncomch,
                       (integer   *) &handle,
                       (ftnlen     ) strlen(fname),        
                       (ftnlen     ) strlen(ftype),        
                       (ftnlen     ) strlen(ifname)  );

    
             for ( i = 0;  i < NMAX;  i++ )
             {
                 ddata[i] = (SpiceDouble)i; 
             }

             n = NMAX;

             dasadd_ ( &handle, &n, ddata );

             dascls_c ( handle );

             return ( 0 );
          }       
          
    
 

Restrictions

 
   None. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman   (JPL) 
   K.R. Gehringer (JPL) 
   W.L. Taber     (JPL) 
 

Version

 
   -CSPICE Version 1.0.0, 05-OCT-2006 (NJB) (KRG) (WLT)

Index_Entries

 
   close a DAS file 
 

Link to routine dascls_c source file dascls_c.c

Wed Apr  5 17:54:31 2017