MPI_STATUS_C2F(3)

okay bestie, welcome to the <strong>Open MPI</strong> manual page for <code>MPI_STATUS_C2F(3)</code></strong> — the page all about flipping a C status into a Fortran <code>INTEGER</code>-style status (and back). the way this is such a niche little conversion moment, but we’re obsessed. 💅✨

💖 NAME 💖

MPI_Status_f2c, MPI_Status_f2c — Translates a C status into a Fortran INTEGER-style status, or vice versa. 🦋

🛠️ 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 — an mpi-style INTEGER MPI status object 🫶
• c_status — a 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. literally none. periodt. 💅

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. 🙈

⚠️ heads-up bestie: undefined error field in, undefined error field out — that’s the vibe, and it is undefined, no cap.

📝 NOTES 📝

ngl, these functions are only available in C; they are not available in any of the Fortran MPI interfaces. so if you were looking for them in Fortran… not today. 😭

👀 SEE ALSO 👀

MPI_Status_f082c MPI_Status_f2f08

💜 COPYRIGHT 💜

2003-2026, The Open MPI Community

---

okay byeeee — footer tea time: this is Open MPI, dated Sep 11, 2026, with the copyright line 2003-2026, The Open MPI Community. 💖🫶🎀