dafopr_c

Index Page dafopr_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 dafopr_c ( ConstSpiceChar    * fname,
                       SpiceInt          * handle  )
#### Abstract
       Open a DAF for subsequent read requests.
#### Required_Reading
       DAF
#### Keywords
       DAF
       FILES
#### Brief_I/O
       Variable  I/O  Description
       --------  ---  --------------------------------------------------
       fname      I   Name of DAF to be opened.
       handle     O   Handle assigned to DAF.
#### Detailed_Input
       fname       is the file name of a DAF to be opened for read
                   access.
#### Detailed_Output
       handle      is the file handle associated with the file. This
                   handle is used to identify the file in subsequent
                   calls to other DAF routines.
#### Parameters
      None.
#### Exceptions
       1) If the specified file has already been opened for read
          access, the handle already associated with the file is
          returned.

       2) If the specified file has already been opened for write
          access, the error SPICE(DAFRWCONFLICT) is signaled.

       3) If the specified file has already been opened by a non-DAF
          routine, the error SPICE(DAFIMPROPOPEN) is signaled.

       4) If the specified file cannot be opened without exceeding
          the maximum number of files, the error SPICE(DAFFTFULL)
          is signaled.

       5) If (for some reason) the file cannot be opened properly,
          the error SPICE(DAFOPENFAIL) is signaled.

       6) If the attempt to read the file's ID word fails, the error
          SPICE(FILEREADFAILED) will be signaled.

       7) If the specified file is not a DAF file, as indicated by the
          file's ID word, the error SPICE(NOTADAFFILE) is signaled.

       8) If no logical units are available, the error will be
          signaled by routines called by this routine.

       9) If the file does not exist, the error SPICE(FILEDOESNOTEXIST)
          is signaled.

      10) If the INQUIRE fails, the error SPICE(INQUIREFAILED)
          is signaled.

      11) If the file record cannot (for some reason) be read,
          the error SPICE(DAFFRNOTFOUND) is signaled.

      12) If the file name is blank, the error SPICE(BLANKFILENAME)
          is signaled.
#### Files
       See argument fname.
#### Particulars
       Most DAFs require only read access. If you do not need to
       change the contents of a file, you should open it with dafopr_c.
#### Examples
       In the following code fragment, dafopr_c is used to open a file,
       which is then searched for DAFs containing data for a particular
       object.

          #include "SpiceUsr.h"
               .
               .
               .
          dafopr_c ( fname, &handle );
          dafbfs_c ( handle );

          daffna_c ( &found );

          while ( found )
          {
             dafgs_c ( sum );
             dafus_c ( sum, ND, NI, dc, ic );

             if ( ic[0] == target_object )
             {
                .
                .
                .
             }

             daffna_c ( &found );
          }
#### Restrictions
       None.
#### Literature_References
       NAIF Document 167.0, "Double Precision Array Files (DAF)
       Specification and User's Guide"
#### Author_and_Institution
       N.J. Bachman    (JPL)
       K.R. Gehringer  (JPL)
       J.M. Lynch      (JPL)
       W.L. Taber      (JPL)
       I.M. Underwood  (JPL)
#### Version
       -CSPICE Version 1.0.0, 01-AUG-1999 (NJB) (KRG) (JML) (WLT) (IMU)
#### Index_Entries
       open daf for read
#### Link to routine dafopr_c source file dafopr_c.c

    Thu Apr 16 08:57:40 2009