next up previous contents FITSIO Home
Next: 5.4 Data I/O Routines Up: 5. Basic Interface Routines Previous: 5.2 File I/O Routines   Contents

5.3 Keyword I/O Routines

1
Put (append) an 80-character record into the CHU.

        FTPREC(unit,card, > status)

2
Put (append) a new keyword of the appropriate datatype into the CHU. The E and D versions of this routine have the added feature that if the 'decimals' parameter is negative, then the 'G' display format rather then the 'E' format will be used when constructing the keyword value, taking the absolute value of 'decimals' for the precision. This will suppress trailing zeros, and will use a fixed format rather than an exponential format, depending on the magnitude of the value.

        FTPKY[JKLS](unit,keyword,keyval,comment, > status)
        FTPKY[EDFG](unit,keyword,keyval,decimals,comment, > status)

3
Get the nth 80-character header record from the CHU. The first keyword in the header is at key_no = 1; if key_no = 0 then this subroutine simple moves the internal pointer to the beginning of the header so that subsequent keyword operations will start at the top of the header; it also returns a blank card value in this case.

        FTGREC(unit,key_no, > card,status)

4
Get a keyword value (with the appropriate datatype) and comment from the CHU

        FTGKY[EDJKLS](unit,keyword, > keyval,comment,status)

5
Delete an existing keyword record.

        FTDKEY(unit,keyword, > status)


next up previous contents FITSIO Home
Next: 5.4 Data I/O Routines Up: 5. Basic Interface Routines Previous: 5.2 File I/O Routines   Contents