Returns FH_SUCCESS if `name' is found and contains either T or F (and not as a string, but as a `logical' FITS card.)
Returns FH_SUCCESS if `name' is found and contains a valid integer. A floating point value (with a decimal point) is not a valid integer. *value will contain the value as converted by the C strtol() function.
Returns FH_SUCCESS if `name' is found and contains a valid float (real) value. *value will contain the result of the C strtod() function.
Returns FH_SUCCESS if `name' is found and contains a FITS string in single quotes ('...'). *value will contain a '0'-terminated list of (up to) the first maxlen characters. (Always pass buffers of (FH_MAX_STRLEN + 1) characters to be sure returned strings will not have to be truncated by the library.)
For access to each of the raw, 80 (FH_CARD_SIZE) records in the header, these functions can be used in a loop (see the ``second way'' in example fhlist.c).
This returns the index of the card last returned by fh_next().
Use this to see if a keyword exists. A return of FH_SUCCESS means the keyword exists. If you pass a non-NULL pointer in `idx', the current `idx' will be returned in *idx.
Prints the first 79 columns of each card to stdout. Column 80 is replaced by a newline, so the terminal doesn't have to have exactly 80 columns to display properly, and the search-forward ('/' key) of `less' can be used. See the example fhlist.c.
Use these functions to obtain `idx' numbers which would cause a new card to appear just before or after an existing card. Note that if the ``new'' card already exists too, it will be replaced and will not be relocated in the header.
Pass the return of this function as the `idx' argument to the fh_set*() routines. Alternatively, you can pass FH_AUTO or a fixed value (see the section on `idx' numbers.)