int MPI_Errhandler_free(MPI_Errhandler *errhandler)
MPI_ERRHANDLER_FREE(ERRHANDLER, IERROR)
int MPI_Error_string(int errorcode, char *string, int *resultlen)
MPI_ERROR_STRING(ERRORCODE, STRING, RESULTLEN, IERROR)
The number of characters actually written
is returned in the output argument, resultlen.
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.)
MPI_ERRHANDLER_FREE( errhandler ) INOUT errhandler MPI error handler (handle)
INTEGER ERRHANDLER, IERROR
void MPI::Errhandler::Free()
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 errorcode Error code returned by an MPI routine OUT string Text that corresponds to the errorcode OUT resultlen Length (in printable characters) of the
result returned in string
INTEGER ERRORCODE, RESULTLEN, IERROR
CHARACTER*(*) STRING
void MPI::Get_error_string(int errorcode, char* name, int& resultlen)
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.
Rationale.
![]()
![]()
![]()
Up: Error Handling
Next: Error Codes and Classes
Previous: Error Handlers for Files
Return to MPI-2.1 Standard Index
Return to MPI Forum Home Page
MPI-2.0 of July 1, 2008
HTML Generated on July 6, 2008