This call is useful for accessing the information associated with a request, without freeing the request (in case the user is expected to access it later). It allows one to layer libraries more conveniently, since multiple layers of software may access the same completed request and extract from it the status information.
| MPI_REQUEST_GET_STATUS( request, flag, status ) | |
| IN request | request (handle) |
| OUT flag | boolean flag, same as from MPI_TEST (logical) |
| OUT status | MPI_STATUS object if flag is true (Status) |
int MPI_Request_get_status(MPI_Request request, int *flag, MPI_Status *status)
MPI_REQUEST_GET_STATUS( REQUEST, FLAG, STATUS, IERROR)
INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR
LOGICAL FLAG
bool MPI::Request::Get_status(MPI::Status& status) const
bool MPI::Request::Get_status() const
Sets flag=true if the operation is complete, and, if so, returns in
status the request status. However, unlike test or wait, it does not
deallocate or inactivate the request; a subsequent call to test, wait or free
should be executed with that request. It sets flag=false if the
operation is not complete.
Up: Nonblocking Communication
Next: Probe and Cancel
Previous: Multiple Completions
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