MPI_Testsome function - Message Passing Interface (original) (raw)

Tests for some of given requests to complete.

Syntax

int MPIAPI MPI_Testsome(
        int                                                incount,
        _Inout_count_(incount) MPI_Request                 *array_of_requests,
  _Out_ int                                                *outcount,
        _Out_cap_post_count_(incount,*outcount) int        *array_of_indices,
        _Out_cap_post_count_(incount,*outcount) MPI_Status *array_of_statuses
);

Parameters

incount
The number of entries in array_of_requests parameter.
array_of_requests
An array of MPI_Request handles of outstanding operations.
outcount [out]
The number of completed requests.
array_of_indices
Array of indices in the array_of_requests of operations that completed. The array_of_requests is indexed from zero in C, and from one in Fortran.
array_of_statuses
Array of status objects for operations that completed, or MPI_STATUSES_IGNORE.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran

    MPI_TESTSOME(INCOUNT, ARRAY_OF_REQUESTS, OUTCOUNT, ARRAY_OF_INDICES, ARRAY_OF_STATUSES, IERROR)
        INTEGER INCOUNT, ARRAY_OF_REQUESTS(*), OUTCOUNT, ARRAY_OF_INDICES(*),
        ARRAY_OF_STATUSES(MPI_STATUS_SIZE,*), IERROR

While it is possible to list a request handle more than once in the array_of_requests, such an action is considered erroneous and may cause the program to unexecpectedly terminate or produce incorrect results.

Requirements