void dskcls_c ( SpiceInt handle,
SpiceBoolean optmiz )
Close a DSK file.
DAS
DSK
DAS
DSK
FILES
TOPOGRAPHY
Variable I/O Description
-------- --- --------------------------------------------------
handle I Handle assigned to the opened DSK file.
optmiz I Flag indicating whether to segregate the DSK.
handle is the DAS file handle associated with the file.
The file may be open for read or write access.
optmiz is a logical flag indicating whether the DSK
should be segregated before it is closed. This
option applies only to files open for write
access. The value of `optmiz' has no effect for
files opened for read access.
See the DAS Required Reading das.req for a
discussion of segregation of DAS files.
None. This routine operates by side effects.
None.
1) If an error occurs when the file is closed, the error will be
diagnosed by routines in the call tree of this routine.
See argument `handle'.
This routine provides a DSK-level interface for closing DSK files.
In cases where DSKs opened for write access are to be closed
without segregation, this interface is slightly simpler than that
available at the DAS level.
1) Close a new DSK file using DAS segregation. `handle'
is the DAS file handle of the DSK.
This is the normal choice for DSK creation.
dskcls_c ( HANDLE, SPICETRUE )
2) Close a new DSK file without using DAS segregation. The
close operation will be fast, but reading the file will be
less efficient than if the file had been segregated.
dskcls_c ( HANDLE, SPICETRUE )
3) Close an existing DSK file that had been opened
for read access. In this case `optmiz' is ignored:
dskcls_c ( HANDLE, SPICEFALSE )
or
dskcls_c ( HANDLE, SPICETRUE )
1) This routine should not be called by user applications
that have loaded a DSK file via furnsh_c. Such applications
should call the functions unload_c or kclear_c instead.
None.
N.J. Bachman (JPL)
-CSPICE Version 1.0.0, 23-JAN-2016 (NJB)
close a dsk file
Link to routine dskcls_c source file dskcls_c.c
|