void dasrfr_c ( SpiceInt handle,
SpiceChar * idword,
SpiceChar * ifname,
SpiceInt * nresvr,
SpiceInt * nresvc,
SpiceInt * ncomr,
SpiceInt * ncomc )
Return the contents of the file record of a specified DAS
Variable I/O Description
-------- --- --------------------------------------------------
handle I DAS file handle.
idwlen I Length of ID word string.
ifnlen I Length of internal file name string.
idword O ID word.
ifname O DAS internal file name.
nresvr O Number of reserved records in file.
nresvc O Number of characters in use in reserved rec. area.
ncomr O Number of comment records in file.
ncomc O Number of characters in use in comment area.
handle is a file handle for a previously opened DAS file.
idwlen is the number of characters available in the output
ID word string. Space for the null terminator is
included in this count.
ifnlen is the number of characters available in the output
internal file name string. Space for the null
terminator is included in this count.
idword is the `ID word' contained in the first eight
characters of the file record.
ifname is the internal file name of the DAS file. The
maximum length of the internal file name is 60
nresvr is the number of reserved records in the DAS file
specified by `handle'.
nresvc is the number of characters in use in the reserved
record area of the DAS file specified by `handle'.
ncomr is the number of comment records in the DAS file
specified by `handle'.
ncomc is the number of characters in use in the comment area
of the DAS file specified by `handle'.
1) If the file read attempted by this routine fails, the error
SPICE(DASFILEREADFAILED) will be signaled.
See the description of `handle' under $Detailed_Input.
This routine provides a convenient way of retrieving the
information contained in the file record of a DAS file.
1) Obtain the internal file name, comment record count, and comment
character count of an existing DAS file.
#define IDWLEN 9
#define IFNLEN 61
#define FILSIZ 256
SpiceChar fname [FILSIZ];
Obtain the file name.
prompt_c ( "Enter DAS file name > ", FILSIZ, fname );
Open the file for reading.
dasopr_c ( fname, &handle );
Retrieve the internal file name and print it.
dasrfr_c ( handle, IDWLEN, IFNLEN, idword,
ifname, &nresvr, &nresvc, &ncomr, &ncomc );
printf ( "Internal file name is: %s\n", ifname );
printf ( "Number of comment records is: %d\n", (int)ncomr );
printf ( "Number of comment characters is: %d\n", (int)ncomc );
N.J. Bachman (JPL)
K.R. Gehringer (JPL)
W.L. Taber (JPL)
-CSPICE Version 1.0.0, 11-NOV-2016 (NJB) (KRG) (WLT)
read DAS file record
read DAS internal file name