5.1 CFITSIO Error Status Routines

1

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)

2

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)

3

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)

4

The fits_write_errmark routine puts an invisible marker on the CFITSIO error stack. The fits_clear_errmark routine can then be used to delete any more recent error messages on the stack, back to the position of the marker. This preserves any older error messages on the stack. The fits_clear_errmsg routine simply clears all the messages (and marks) from the stack. These routines are called without any arguments.

  void fits_write_errmark / ffpmrk (void)
  void fits_clear_errmark / ffcmrk (void)
  void fits_clear_errmsg / ffcmsg (void)