next up previous contents FITSIO Home
Next: Read Keyword Subroutines Up: FITS Header I/O Subroutines Previous: Write Keyword Subroutines

Insert Keyword Subroutines  

1
Insert a new keyword record into the CHU at the specified position (i.e., immediately preceding the (keyno)th keyword in the header.) This 'insert record' subroutine is somewhat less efficient then the 'append record' subroutine (FTPREC) described above because the remaining keywords in the header have to be shifted down one slot.

        FTIREC(unit,key_no,card, > status)

2
Insert a new keyword into the CHU. The new keyword is inserted immediately following the last keyword that has been read from the header. These 'insert keyword' subroutines are somewhat less efficient then the 'append keyword' subroutines described above because the remaining keywords in the header have to be shifted down one slot.

        FTIKY[JLS](unit,keyword,keyval,comment, > status)
        FTIKY[EDFG](unit,keyword,keyval,decimals,comment, > status)

3
Insert a new keyword with an undefined, or null, value into the CHU. The value string of the keyword is left blank in this case.

        FTIKYU(unit,keyword,comment, > status)