next up previous contents FITSIO Home
Next: FITS File Access Routines Up: Basic CFITSIO Interface Routines Previous: Basic CFITSIO Interface Routines   Contents

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
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)


next up previous contents FITSIO Home
Next: FITS File Access Routines Up: Basic CFITSIO Interface Routines Previous: Basic CFITSIO Interface Routines   Contents