petsc-3.7.3 2016-08-01

SETERRQ8

Macro that is called when an error has been detected,

#include <petscsys.h>
PetscErrorCode SETERRQ8(MPI_Comm comm,PetscErrorCode errorcode,char *formatmessage,arg1,arg2,arg3)

Not Collective

	comm	- A communicator, so that the error can be collective
	errorcode	- nonzero error code, see the list of standard error codes in include/petscerror.h
	message	- error message in the printf format
	arg1	- argument (for example an integer, string or double)
	arg2	- argument (for example an integer, string or double)
	arg3	- argument (for example an integer, string or double)
	arg4	- argument (for example an integer, string or double)
	arg5	- argument (for example an integer, string or double)
	arg6	- argument (for example an integer, string or double)
	arg7	- argument (for example an integer, string or double)
	arg8	- argument (for example an integer, string or double)

Once the error handler is called the calling function is then returned from with the given error code.

There are also versions for 4, 5, 6 and 7 arguments.

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