MPI_STATUS_F082C(3)

πŸ’– MPI_STATUS_F082C(3) πŸ’–

okay so this is the Open MPI manual page for MPI_Status_f082c and MPI_Status_c2f08, and it's literally about translating a C status into a Fortran 2008 status, or vice versa. Bestie, let's get into it πŸ’….

✨ NAME ✨

MPI_Status_f082c, MPI_Status_c2f08 β€” Translates a C status into a Fortran 2008 status, or vice versa.

🌸 SYNOPSIS 🌸

πŸ’» C Syntax πŸ’»

#include <mpi.h>

int MPI_Status_f082c(const MPI_F08_status *f08_status, MPI_Status *c_status)
int MPI_Status_c2f08(const MPI_Status *c_status, MPI_F08_status *f08_status)

πŸŽ€ PARAMETERS πŸŽ€

  • f08_status β€” mpi_f08-style MPI status object
  • c_status β€” C-style MPI status object

πŸ¦‹ DESCRIPTION πŸ¦‹

These two procedures are provided in C to convert from a Fortran 2008 status (which is a derived type made 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 β€” not a crumb, not a vibe πŸ’….

When using MPI_Status_f082c, if f08_status is a valid Fortran status, but not the Fortran value of MPI_F08_STATUS_IGNORE or MPI_F08_STATUSES_IGNORE, then MPI_Status_f082c returns in c_status a valid C status with the same content. If f08_status is the Fortran value of MPI_STATUS_IGNORE or MPI_STATUSES_IGNORE, or if f08_status is not a valid Fortran status, then the call is erroneous. Like, do not do that. 🫠

When using MPI_Status_c2f08, 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. Same energy: 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. Undefined means undefined, bestie β€” no cap. ⚠️

πŸ’… NOTES πŸ’…

These functions are only available in C; they are not available in any of the Fortran MPI interfaces. So if you're living that Fortran MPI life, these particular functions are not it. πŸ™ˆ

πŸ‘€ SEE ALSO πŸ‘€

  • MPI_Status_c2f
  • MPI_Status_f2f08

2003-2026, The Open MPI Community


love u, bye πŸ«ΆπŸ’– β€” from the Open MPI manual, dated May 14, 2026 ✨

πŸ“¦ where this page comes from