Procedure

   void dasopr_c ( ConstSpiceChar  * fname,
                   SpiceInt        * handle ) 

Abstract

 
   Open a DAS file for reading. 
 

Required_Reading

 
   DAS 
 

Keywords

 
   DAS 
   FILES 
 

Brief_I/O

 
   Variable  I/O  Description 
   --------  ---  -------------------------------------------------- 
   fname      I   Name of a DAS file to be opened. 
   handle     O   Handle assigned to the opened DAS file. 
 

Detailed_Input

 
   fname       is the name of a DAS file to be opened with read 
               access. 
 

Detailed_Output

 
   handle      is the handle that is  associated with the file. This 
               handle is used to identify the file in subsequent 
               calls to other DAS routines. 
 

Parameters

 
   None. 
 

Exceptions

 
   1) If the input filename is blank, the error SPICE(BLANKFILENAME) 
      will be signaled. 
 
   2) If the specified file does not exist, the error 
      SPICE(FILENOTFOUND) will be signaled. 
 
   3) If the specified file has already been opened for read 
      access, the handle already associated with the file is 
      returned. 
 
   4) If the specified file has already been opened for write 
      access, the error SPICE(DASRWCONFLICT) is signaled. 
 
   5) If the specified file has already been opened by a non-DAS 
      routine, the error SPICE(DASIMPROPOPEN) is signaled. 
 
   6) If the specified file cannot be opened without exceeding 
      the maximum allowed number of open DAS files, the error 
      SPICE(DASFTFULL) is signaled. 
 
   7) If the named file cannot be opened properly, the error 
      SPICE(DASOPENFAIL) is signaled. 
 
   8) If the file record cannot be read, the error 
      SPICE(FILEREADFAILED) will be signaled. 
 
   9) If the specified file is not a DAS file, as indicated by the 
      file's ID word, the error SPICE(NOTADASFILE) is signaled. 
 
  10) If no logical units are available, the error will be 
      signaled by routines called by this routine. 
 

Files

 
   See argument `fname'. 
 

Particulars

 
   Most DAS files require only read access. If you do not need to 
   change the contents of a file, you should open it using dasopr_c. 
 

Examples

 
   1)  Open the existing DAS file TEST.DAS for reading. 
 
          dasopr_c ( "TEST.DAS", &handle );
 

Restrictions

 
   None. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman    (JPL) 
   K.R. Gehringer  (JPL) 
   W.L. Taber      (JPL) 
   F.S. Turner     (JPL) 
   I.M. Underwood  (JPL) 
 

Version

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

Index_Entries

 
   open a DAS file for reading 
   open a DAS file for read access 
 

Link to routine dasopr_c source file dasopr_c.c