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


6.4.4 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. The FTIKLS subroutine works the same as the FTIKYS subroutine, except it also supports long string values greater than 68 characters in length. 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.

        FTIKEY(unit, card, > status)
        FTIKY[JKLS](unit,keyword,keyval,comment, > status)
        FTIKLS(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)


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