SETERRQ#

Macro to be called when an error has been detected,

Synopsis#

#include <petscsys.h>
PetscErrorCode SETERRQ(MPI_Comm comm,PetscErrorCode ierr,char *message,...)

Collective

Input Parameters#

comm - A communicator, use PETSC_COMM_SELF unless you know all ranks of another communicator will detect the error
ierr - nonzero error code, see the list of standard error codes in include/petscerror.h
message - error message

Notes#

This is rarely needed, one should use PetscCheck() and PetscCall() and friends to automatically handle error conditions. Once the error handler is called the calling function is then returned from with the given error code.

Experienced users can set the error handler with PetscPushErrorHandler().