MPI_Status_f2c function

Converts from a Fortran status (which is an array of integers) to a C status (which is a structure). The conversion occurs on all the information in status, including that which is hidden. That is, no status information is lost in the conversion.

Syntax

int MPIAPI MPI_Status_f2c(
  _In_  MPI_Fint   *f_status,
  _Out_ MPI_Status *status
);

Parameters

  • f_status [in]
    Fortran status.

  • status [out]
    C status.

Return value

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

Remarks

If f_status is a valid Fortran status, but not the Fortran value of MPI_STATUS_IGNORE or MPI_STATUSES_IGNORE, then 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, then the call is erroneous.

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 may 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

Requirements

Product

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities

Header

Mpi.h; Mpif.h

Library

Msmpi.lib

DLL

Msmpi.dll

See also

MPI Miscellaneous Functions