MPI_STATUS_SET_ELEMENTS(3)MPI_STATUS_SET_ELEMENTS(3)NAMEMPI_Status_set_elements - Fills in "elements" status variable field
SYNOPSIS
C:
#include <mpi.h>
int MPI_Status_set_elements(status, datatype, count)
MPI_Status *status;
MPI_Datatype datatype;
int countR;
C++: (Not currently implemented)
#include <mpi.h>
void MPI::Status::Set_elements(const MPI::Datatype& datatype, count)
Fortran:
INCLUDE "mpif.h" (or USE MPI)
MPI_STATUS_SET_ELEMENTS(status, datatype, count, ierr)
INTEGER status(MPI_STATUS_SIZE), datatype, count, ierr
STANDARDS
This release implements the MPI 2.0 standard, as documented by the MPI
Forum in the July 1997 release of MPI: A Message Passing Interface
Standard.
DESCRIPTION
This call modifies the opaque part of status so that a subsequent call to
MPI_Get_elements will return count. MPI_Get_count returns a compatible
value. Both routines must be passed an argument with the same type
signature as datatype.
status Specifies the status variable to be modified. (array)
datatype Specifies the datatype associated with count. (handle)
count Specifies the number of elements to associate with status.
(integer)
NOTES
All MPI routines in Fortran (except for MPI_Wtime(3) and MPI_Wtick(3))
have an additional ierr argument at the end of the argument list. ierr
is an integer and has the same meaning as the return value of the routine
in C. In Fortran, MPI routines are subroutines and are invoked with the
Page 1
MPI_STATUS_SET_ELEMENTS(3)MPI_STATUS_SET_ELEMENTS(3)
CALL statement. Additionally, in Fortran, all MPI objects (for example,
MPI_Datatype and MPI_Comm) are of type integer.
SEE ALSOMPI_Get_count(3), MPI_Get_elements(3), MPI_Grequest_start(3),
MPI_Status_set_cancelled(3),
Page 2