FITSIO Home
Next: Read or Write Standard
Up: FITS Header I/O Subroutines
Previous: FITS Header I/O Subroutines
- 1
- Reserve space in the CHU for MOREKEYS more header keywords.
This subroutine may be called to reserve space for keywords which are
to be written at a later time, after the data unit or subsequent
extensions have been written to the FITS file. If this subroutine is
not explicitly called, then the initial size of the FITS header will be
limited to the space available at the time that the first data is written
to the associated data unit. FITSIO has the ability to dynamically
add more space to the header if needed, however it is more efficient
to preallocate the required space if the size is known in advance.
FTHDEF(unit,morekeys, > status)
- 2
- Return the number of existing keywords in the CHU (NOT including the
END keyword which is not considered a real keyword) and the remaining
space available to write additional keywords in the CHU. (returns
KEYSADD = -1 if the header has not yet been closed).
Note that FITSIO will attempt to dynamically add space for more
keywords if required when appending new keywords to a header.
FTGHSP(iunit, > keysexist,keysadd,status)
- 3
- Return the number of keywords in the header and the current position
in the header. This returns the number of the keyword record that
will be read next (or one greater than the position of the last keyword
that was read or written). A value of 1 is returned if the pointer is
positioned at the beginning of the header.
FTGHPS(iunit, > keysexist,key_no,status)
FITSIO Home
Next: Read or Write Standard
Up: FITS Header I/O Subroutines
Previous: FITS Header I/O Subroutines