Table of contents
dashfn_c ( DAS, handle to file name )
void dashfn_c ( SpiceInt handle,
SpiceChar * fname )
Return the name of the DAS file associated with a handle.
VARIABLE I/O DESCRIPTION
-------- --- --------------------------------------------------
handle I Handle of a DAS file.
namlen I Length of output file name string.
fname O Corresponding file name.
handle is the handle of a previously opened DAS file.
namlen is the count of characters in the output string,
including room for the terminating null character.
fname is the name of the DAS file associated with the input
1) If the specified handle does not belong to any file that is
currently known to be open, the error SPICE(DASNOSUCHHANDLE)
is signaled by a routine in the call tree of this routine.
2) If `fname' string is too short to contain the output string,
the name is truncated on the right.
3) If the `fname' output string pointer is null, the error
SPICE(NULLPOINTER) is signaled.
4) If the `fname' output string has length less than two
characters, the error SPICE(STRINGTOOSHORT) is signaled, since
the output string is too short to contain one character of
output data plus a null terminator.
See the description of the argument `handle' in -Detailed_Input.
It may be desirable to recover the names of one or more DAS
files in a different part of the program from the one in which
they were opened. Note that the names returned by dashfn_c may
not be identical to the names used to open the files. Under
most operating systems, a particular file can be accessed using
many different names. dashfn_c returns one of them.
The numerical results shown for this example may differ across
platforms. The results depend on the SPICE kernels used as
input, the compiler and supporting libraries, and the machine
specific arithmetic implementation.
1) In the following program, the name of a DAS file is
recovered using the handle associated with the file.
Use the DSK kernel below as input DAS file for the example.
Example code begins here.
#define DAS "phobos512.bds"
#define FILSIZ 256
SpiceChar fname [ FILSIZ ];
Open the DAS file for read access.
dasopr_c ( DAS, &handle );
Map the handle to a file name.
dashfn_c ( handle, FILSIZ, fname );
printf ( "DAS file name = <%s>.\n", fname );
return ( 0 );
When this program was executed on a Mac/Intel/cc/64-bit
platform, the output was:
DAS file name = <phobos512.bds>.
N.J. Bachman (JPL)
J. Diaz del Rio (ODC Space)
K.R. Gehringer (JPL)
W.L. Taber (JPL)
I.M. Underwood (JPL)
-CSPICE Version 1.0.1, 10-AUG-2021 (JDR)
Edited the header to comply with NAIF standard.
-CSPICE Version 1.0.0, 10-DEC-2016 (NJB) (KRG) (WLT) (IMU)
map DAS handle to file name