plucky (3) MPI_Status_f2c.3.gz

Provided by: openmpi-doc_5.0.7-1_all bug

SYNTAX
   C Syntax
          #include <mpi.h>

          int MPI_Status_f2c(const MPI_Fint *f_status, MPI_Status *c_status)
          int MPI_Status_c2f(const MPI_Status *c_status, MPI_Fint *f_status)


PARAMETERS
       • f_status : mpi-style INTEGER MPI status object

       • c_status : C-style MPI status object


DESCRIPTION
       These two procedures are provided in C to convert from a Fortran status (which is an array  of  integers)
       to  a  C  status  (which is a structure), and vice versa. The conversion occurs on all the information in
       status, including that which is hidden. That is, no status information is lost in the conversion.

       When using MPI_Status_f2c, 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.

       When  using  MPI_Status_c2f,  the  opposite  conversion  is  applied. If c_status is MPI_STATUS_IGNORE or
       MPI_STATUSES_IGNORE, or if c_status is not a valid C status, then the call is erroneous.

       The input status has the same source, tag and error code values as the output  status,  and  returns  the
       same  answers  when  queried for count, elements, and cancellation. The conversion function may be called
       with an input status argument that has an undefined error field, in which case the  value  of  the  error
       field in the output status argument is undefined.


NOTES
       These functions are only available in C; they are not available in any of the Fortran MPI interfaces.

       SEE ALSO:
          MPI_Status_f082c MPI_Status_f2f08


       2003-2025, The Open MPI Community

                                                  Feb 17, 2025                                 MPI_STATUS_C2F(3)