Purpose
Converts a FORTRAN status object into a C status object.
C synopsis
#include <mpi.h> int MPI_Status_f2c(MPI_Fint *f_status, MPI_Status *c_status);
Parameters
Description
This function converts a FORTRAN status object (which is a user-declared array of integers) to a C status object (which is a user-declared structure object). The conversion occurs on all the information in status, including that which is hidden. That is, no status information is lost in the conversion.
If f_status is a valid FORTRAN status, but not the FORTRAN value of MPI_STATUS_IGNORE or MPI_STATUSES_IGNORE, MPI_Status_f2c returns in c_status a valid C status with the same content. If f_status is the FORTRAN value of MPI_STATUS_IGNORE or MPI_STATUSES_IGNORE, or if f_status is not a valid FORTRAN status, the call is erroneous.
The predeclared global variables MPI_F_STATUS_IGNORE and MPI_F_STATUSES_IGNORE can be used to test whether f_status is one of the ignore values.
The C status has the same source, tag and error code values as the FORTRAN status, and returns the same answers when queried for count, elements, and cancellation. The conversion function can be called with a FORTRAN status argument that has an undefined error field, in which case the value of the error field in the C status argument is undefined.
There is not a separate conversion function for arrays of statuses, as you one can simply loop through the array, converting each status.
Errors
No errors are detected.
Related information