public class Request
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
mpjdev.Request |
req |
Constructor and Description |
---|
Request(mpjdev.Request req) |
Modifier and Type | Method and Description |
---|---|
void |
Cancel()
Mark a pending nonblocking communication for cancellation.
|
void |
finalize() |
boolean |
Is_null()
Test if request object is void.
|
Status |
Test()
Returns a status object if the operation identified by the request is complete, or a null reference otherwise.
|
static Status[] |
Testall(Request[] r)
Tests for completion of all of the operations associated with active requests.
|
static Status |
Testany(Request[] r)
Tests for completion of either one or none of the operations associated with active requests.
|
static Status[] |
Testsome(Request[] r)
Behaves like Waitsome, except that it returns immediately.
|
Status |
Wait()
Blocks until the operation identified by the request is complete.
|
static Status[] |
Waitall(Request[] r)
Blocks until all of the operations associated with the active requests in the array have completed.
|
static Status |
Waitany(Request[] r)
Blocks until one of the operations associated with the active requests in the array has completed.
|
static Status[] |
Waitsome(Request[] r)
Blocks until at least one of the operations associated with the active requests in the array has completed.
|
public Status Wait() throws MPIException
returns: | status object |
Java binding of the MPI operation MPI_WAIT.
After the call returns, the request object becomes inactive.
MPIException
public Status Test() throws MPIException
returns: | status object or null reference |
Java binding of the MPI operation MPI_TEST.
After the call, if the operation is complete (ie, if the return value is non-null), the request object becomes inactive.
MPIException
public static Status Testany(Request[] r) throws MPIException
array_of_requests | array of requests |
returns: | status object or null reference |
Java binding of the MPI operation MPI_TESTANY.
If some request completed, the index in array_of_requests for that request can be obtained from the returned status object through the. The corresponding element of array_of_requests becomes inactive. If no request completed, Testany returns a null reference.
MPIException
public void finalize() throws MPIException
finalize
in class java.lang.Object
MPIException
public boolean Is_null() throws MPIException
returns: | true if the request object is void, false otherwise |
MPIException
public static Status[] Waitall(Request[] r) throws MPIException
array_of_requests | array of requests |
returns: | array of status objects |
Java binding of the MPI operation MPI_WAITALL.
The result array will be the same size as array_of_requests. On exit, requests become inactive. If the input value of arrayOfRequests contains inactive requests, corresponding elements of the result array will contain null status references.
MPIException
public static Status Waitany(Request[] r) throws MPIException
array_of_requests | array of requests |
returns: | status object |
Java binding of the MPI operation MPI_WAITANY.
The index in array_of_requests for the request that completed can be obtained from the returned status object through the Status.index field. The corresponding element of array_of_requests becomes inactive.
MPIException
public static Status[] Testall(Request[] r) throws MPIException
array_of_requests | array of requests |
returns: | array of status objects |
Java binding of the MPI operation MPI_TESTALL.
If all operations have completed, the exit value of the argument array and the result array are as for Waitall. If any operation has not completed, the result value is null and no element of the argument array is modified.
MPIException
public static Status[] Waitsome(Request[] r) throws MPIException
array_of_requests | array of requests |
returns: | array of status objects |
Java binding of the MPI operation MPI_WAITSOME.
The size of the result array will be the number of operations that completed. The index in array_of_requests for each request that completed can be obtained from the returned status objects through the Status.index field. The corresponding element in array_of_requests becomes inactive.
MPIException
public static Status[] Testsome(Request[] r) throws MPIException
array_of_requests | array of requests |
returns: | array of status objects |
Java binding of the MPI operation MPI_TESTSOME.
If no operation has completed, TestSome returns an array of length zero and elements of array_of_requests are unchanged. Otherwise, arguments and return value are as for Waitsome.
MPIException
public void Cancel() throws MPIException
MPIException