CFITSIO Error Status Routines

1

Return the revision number of the CFITSIO library. The revision number will be incremented whenever any modifications or enhancements are made to the code.  

  float fits_get_version / ffvers ( > float *version)

2

Return a descriptive text string (30 char max.) corresponding to a CFITSIO error status code.  

  void fits_get_errstatus / ffgerr (int status, > char *err_text)

3

Return the top (oldest) 80-character error message from the internal CFITSIO stack of error messages and shift any remaining messages on the stack up one level. Call this routine repeatedly to get each message in sequence. The function returns a value = 0 and a null error message when the error stack is empty.  

  int fits_read_errmsg / ffgmsg (char *err_msg)

4

Print out the error message corresponding to the input status value and all the error messages on the CFITSIO stack to the specified file stream (normally to stdout or stderr). If the input status value = 0 then this routine does nothing.  

  void fits_report_error / ffrprt (FILE *stream, status)

5

Write an 80-character message to the CFITSIO error stack. Application programs should not normally write to the stack, but there may be some situations where this is desirable.  

  void fits_write_errmsg / ffpmsg (char *err_msg)

6

Clear the entire error message stack. This routine is useful to clear any error message that may have been generated by a non-fatal CFITSIO error. This routine is called without any arguments.  

  void fits_clear_errmsg / ffcmsg (void)