Modify Keyword Routines

Wild card characters, as described in the Read Keyword section, above, may be used when specifying the name of the keyword to be modified.

1

Modify (overwrite) the nth 80-character header record in the CHU.

  int fits_modify_record / ffmrec
      (fitsfile *fptr, int keynum, char *card, > int *status)

2

Modify (overwrite) the 80-character header record for the named keyword in the CHU. This can be used to overwrite the name of the keyword as well as its value and comment fields.

  int fits_modify_card / ffmcrd
      (fitsfile *fptr, char *keyname, char *card, > int *status)

3

Modify (overwrite) the name of an existing keyword in the CHU preserving the current value and comment fields.

  int fits_modify_name / ffmnam
      (fitsfile *fptr, char *oldname, char *newname, > int *status)

4

Modify (overwrite) the comment field of an existing keyword in the CHU.

  int fits_modify_comment / ffmcom
      (fitsfile *fptr, char *keyname, char *comment, > int *status)

5

Modify the value and comment fields of an existing keyword in the CHU. Optionally, one may modify only the value field and leave the comment field unchanged by setting the input COMMENT parameter equal to the ampersand character (&).

  int fits_modify_key_str / ffmkys
      (fitsfile *fptr, char *keyname, char *value, char *comment,
       > int *status);

  int fits_modify_key_[log, lng] / ffmky[lj]
      (fitsfile *fptr, char *keyname, DTYPE numval, char *comment,
       > int *status)

  int fits_modify_key_[flt, dbl, fixflt, fixdbl] / ffmky[edfg]
      (fitsfile *fptr, char *keyname, DTYPE numval, int decimals,
                  char *comment, > int *status)

6

Modify the value of an existing keyword to be undefined, or null. The value string of the keyword is set to blank. Optionally, one may leave the comment field unchanged by setting the input COMMENT parameter equal to the ampersand character (&).

  int fits_modify_key_null / ffmkyu
      (fitsfile *fptr, char *keyname, char *comment, > int *status)