UDF PROGRAMMERS MANUAL





 ReOpenFile (1) 
     UDF PROGRAMMERS MANUAL
     ReOpenFile (1)
 


 
  NAME   ReOpenFile




 SYNOPSIS 




 #include "libbase_udf.h"


 ByTe_2
     ReOpenFile
     (u_ByTe_4 Key, ByTe_1 *Ext, 
                       u_ByTe_2 Ver, void *UDF, 
                       ByTe_2 Byear, ByTe_2 Bday, 
                       ByTe_4 Bsec, ByTe_4 Bnsec,
                       ByTe_2 Eyear, ByTe_2 Eday, 
                       ByTe_4 Esec, ByTe_4 Ensec, 
                       ByTe_1 Status);







 INPUT DEFINITIONS  




 Key
     -
     UDF data key


 Ext
     -
     UDF file extension


 Ver
     -
     Version number


 UDF
     -
     General data structure


 Byear
     -
     Beginning year of requested data


 Bday
     -
     Beginning day of year of requested data


 Bsec
     -
     Beginning second of day of requested data


 Bnsec
     -
     Beginning nanosecond of second of requested data
 Eyear
     -
     Ending year of requested data


 Eday
     -
     Ending day of year of requested data


 Esec
     -
     Ending second of day of requested data


 Ensec
     -
     Ending nanosecond of second of requested data


 Status
     -
     Last read_drec 
                      returned status







  DESCRIPTION  
  ReOpenFile() uses the return status of the last
read_drec call to determine if there is any
subsequent action which needs to be taken.  Specifically the routine
will see if a the read_drec is requesting
that the next UDF data file be opened.  If this is the case this
routine will close the current UDF file, open the next file,
and position the data pointer. 




If the beginning year is set to 0 then the routine will position the
new file pointer to the time corresponding to to the ending time of the 
measurement found in the last read_drec call.
With a non-zero beginning year the file pointer will position itself to
the time specified.






  RETURN VALUE  
 If no action is taken the routine simply returns the value
of Status - otherwise the status returned will be that 
from one of the UDF internal routines used.




  ERRORS  

  Generated from internal routines
  




  APPLICABLE FORMATS  
  UDF V2.2, IDFS V2.1




  RESTRICTIONS  
None




  SEE ALSO  
ret_codes(1H)
read_drec(1U)










 UDF V2.2 
     July 31, 1999
     UDF V2.2
 










  

    
    TOC
    HOME