Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.stsci.edu/~sontag/spicedocs/cspice/dafopr_c.html
Дата изменения: Sat Dec 17 06:08:42 2005 Дата индексирования: Sun Apr 10 23:59:06 2016 Кодировка: Поисковые слова: redshift survey |
Open a DAF for subsequent read requests.
DAF
Variable I/O Description -------- --- -------------------------------------------------- fname I Name of DAF to be opened. handle O Handle assigned to DAF.
fname is the file name of a DAF to be opened for read access.
handle is the file handle associated with the file. This handle is used to identify the file in subsequent calls to other DAF routines.
None.
Most DAFs require only read access. If you do not need to change the contents of a file, you should open it with dafopr_c.
In the following code fragment, dafopr_c is used to open a file, which is then searched for DAFs containing data for a particular object. #include "SpiceUsr.h" . . . dafopr_c ( fname, &handle ); dafbfs_c ( handle ); daffna_c ( &found ); while ( found ) { dafgs_c ( sum ); dafus_c ( sum, ND, NI, dc, ic ); if ( ic[0] == target_object ) { . . . } daffna_c ( &found ); }
None.
1) If the specified file has already been opened for read access, the handle already associated with the file is returned. 2) If the specified file has already been opened for write access, the error SPICE(DAFRWCONFLICT) is signaled. 3) If the specified file has already been opened by a non-DAF routine, the error SPICE(DAFIMPROPOPEN) is signaled. 4) If the specified file cannot be opened without exceeding the maximum number of files, the error SPICE(DAFFTFULL) is signaled. 5) If (for some reason) the file cannot be opened properly, the error SPICE(DAFOPENFAIL) is signaled. 6) If the attempt to read the file's ID word fails, the error SPICE(FILEREADFAILED) will be signaled. 7) If the specified file is not a DAF file, as indicated by the file's ID word, the error SPICE(NOTADAFFILE) is signaled. 8) If no logical units are available, the error will be signaled by routines called by this routine. 9) If the file does not exist, the error SPICE(FILEDOESNOTEXIST) is signaled. 10) If the INQUIRE fails, the error SPICE(INQUIREFAILED) is signaled. 11) If the file record cannot (for some reason) be read, the error SPICE(DAFFRNOTFOUND) is signaled. 12) If the file name is blank, the error SPICE(BLANKFILENAME) is signaled.
See argument fname.
N.J. Bachman (JPL) K.R. Gehringer (JPL) J.M. Lynch (JPL) W.L. Taber (JPL) I.M. Underwood (JPL)
NAIF Document 167.0, "Double Precision Array Files (DAF) Specification and User's Guide"
-CSPICE Version 1.0.0, 01-AUG-1999 (NJB) (KRG) (JML) (WLT) (IMU)
open daf for read