Index Page dasopw_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 dasopw_c ( ConstSpiceChar  * fname,
                       SpiceInt        * handle )

#### Abstract

       Open a DAS file for writing.

#### 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 write
                   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, either by the DAS
           file routines or by other code, the error SPICE(DASOPENCONFLICT)
           is signaled. Note that this response is not paralleled by
           dasopr_c, which allows you to open a DAS file for reading even
           if it is already open for reading.

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

       5)  If the named file cannot be opened properly, the error
           SPICE(DASOPENFAIL) is signaled.

       6)  If the file record cannot be read, the error
           SPICE(FILEREADFAILED) will be signaled.

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

       8)  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 writing.

              dasopw_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, 11-NOV-2016 (NJB) (KRG) (WLT) (FST) (IMU)

#### Index_Entries

       open a DAS file for writing
       open a DAS file for write access

#### Link to routine dasopw_c source file dasopw_c.c

    Wed Apr  5 17:54:31 2017