Procedure

   dasdc_c ( DAS, delete comments ) 

   void dasdc_c ( SpiceInt handle )

Abstract

   Delete the entire comment area of a previously opened binary
   DAS file.

Required_Reading

   DAS

Keywords

   None.

Brief_I/O

   VARIABLE  I/O  DESCRIPTION
   --------  ---  --------------------------------------------------
   handle     I   The handle of a binary DAS file opened for writing.

Detailed_Input

   handle      The handle of a binary DAS file that is to have its
               entire comment area deleted. The DAS file should have
               been opened with write access.

Detailed_Output

   None.

Parameters

   None.

Exceptions

   1)  If the binary DAS file attached to `handle' is not open with
       write access, an error is signaled by a routine in the call
       tree of this routine.

Files

   See argument `handle' in -Detailed_Input.

Particulars

   Binary DAS files contain an area which is reserved for storing
   annotations or descriptive textual information about the data
   contained in a file. This area is referred to as the ``comment
   area'' of the file. The comment area of a DAS file is a line
   oriented medium for storing textual information. The comment area
   preserves any leading or embedded white space in the line(s) of text
   which are stored, so that the appearance of the information will be
   unchanged when it is retrieved (extracted) at some other time.
   Trailing blanks, however, are NOT preserved, due to the way that
   character strings are represented in standard Fortran 77.

   This routine will delete the entire comment area from the binary
   DAS file attached to `handle'. The size of the binary DAS file will
   remain unchanged. The space that was used by the comment records
   is reclaimed.

Examples

   Let

         `handle' be the handle for a DAS file which has been opened
         with write access.

   The call

         dasdc_c ( handle )

   will delete the entire comment area of the binary DAS file
   attached to `handle'.

Restrictions

   None.

Literature_References

   None.

Author_and_Institution

   N.J. Bachman        (JPL)
   J. Diaz del Rio     (ODC Space)
   K.R. Gehringer      (JPL)

Version

   -CSPICE Version 1.0.1, 10-AUG-2021 (JDR)

       Edited the header to comply with NAIF standard.

   -CSPICE Version 1.0.0, 11-NOV-2016 (NJB) (KRG)

Index_Entries

   delete DAS comment area