| MPI_ERRHANDLER_FREE( errhandler ) | |
| INOUT errhandler | MPI error handler (handle) |
int MPI_Errhandler_free(MPI_Errhandler *errhandler)
MPI_Errhandler_free(errhandler, ierror)
TYPE(MPI_Errhandler), INTENT(INOUT) :: errhandler
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
MPI_ERRHANDLER_FREE(ERRHANDLER, IERROR)
INTEGER ERRHANDLER, IERROR
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, INTENT(IN) :: errorcode
CHARACTER(LEN=MPI_MAX_ERROR_STRING), INTENT(OUT) :: string
INTEGER, INTENT(OUT) :: resultlen
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
MPI_ERROR_STRING(ERRORCODE, STRING, RESULTLEN, IERROR)
INTEGER ERRORCODE, RESULTLEN, IERROR
CHARACTER*(*) 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.
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.)