| MPI_ERRHANDLER_FREE(errhandler) | |
| INOUT errhandler | MPI error handler (handle) |
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 |
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. This function must always be thread-safe, as defined in Section MPI and Threads. It is one of the few routines that may be called before MPI is initialized or after MPI is finalized.
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.)