180. Freeing Errorhandlers and Retrieving Error Strings


Up: Error Handling Next: Error Codes and Classes Previous: Error Handlers for Files

MPI_ERRHANDLER_FREE( errhandler )
INOUT errhandlerMPI error handler (handle)

int MPI_Errhandler_free(MPI_Errhandler *errhandler)

MPI_ERRHANDLER_FREE(ERRHANDLER, IERROR)
INTEGER ERRHANDLER, IERROR
{ void MPI::Errhandler::Free() (binding deprecated, see Section Deprecated since MPI-2.2 ) }
Marks the error handler associated with errhandler for deallocation and sets errhandler to MPI_ERRHANDLER_NULL. The error handler will be deallocated after all the objects associated with it (communicator, window, or file) have been deallocated.

MPI_ERROR_STRING( errorcode, string, resultlen )
IN errorcodeError code returned by an MPI routine
OUT stringText that corresponds to the errorcode
OUT resultlenLength (in printable characters) of the result returned in string

int MPI_Error_string(int errorcode, char *string, int *resultlen)

MPI_ERROR_STRING(ERRORCODE, STRING, RESULTLEN, IERROR)
INTEGER ERRORCODE, RESULTLEN, IERROR
CHARACTER*(*) STRING
{ void MPI::Get_error_string(int errorcode, char* name, int& resultlen) (binding deprecated, see Section Deprecated since MPI-2.2 ) }
Returns the error string associated with an error code or class. The argument string must represent storage that is at least MPI_MAX_ERROR_STRING characters long.

The number of characters actually written is returned in the output argument, resultlen.


Rationale.

The form of this function was chosen to make the Fortran and C bindings similar. A version that returns a pointer to a string has two difficulties. First, the return string must be statically allocated and different for each error message (allowing the pointers returned by successive calls to MPI_ERROR_STRING to point to the correct message). Second, in Fortran, a function declared as returning CHARACTER*(*) can not be referenced in, for example, a PRINT statement. ( End of rationale.)



Up: Error Handling Next: Error Codes and Classes Previous: Error Handlers for Files


Return to MPI-2.2 Standard Index
Return to MPI Forum Home Page

(Unofficial) MPI-2.2 of September 4, 2009
HTML Generated on September 10, 2009