| MPI_ERRHANDLER_FREE( errhandler ) | |
| INOUT errhandler | MPI error handler (handle) |
int MPI_Errhandler_free(MPI_Errhandler *errhandler)
MPI_ERRHANDLER_FREE(ERRHANDLER, IERROR)
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 |
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)
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.)