dasopr_c

Index Page dasopr_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 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

    Thu Apr 16 08:57:42 2009