MPI_REQUEST_F2C(3)
π NAME π
okay so bestie, say hi to the whole handshake squad π β this is the MPI_REQUEST_F2C(3) page from the Open MPI manual (section 3, iykyk).
Here's everybody on the roster:
MPI_Comm_f2cMPI_Comm_c2fMPI_File_f2cMPI_File_c2fMPI_Info_f2cMPI_Info_c2fMPI_Message_f2cMPI_Message_c2fMPI_Op_f2cMPI_Op_c2fMPI_Request_f2cMPI_Request_c2fMPI_Type_f2cMPI_Type_c2fMPI_Win_f2cMPI_Win_c2f
And what do they do, you ask? β¨ Translates a C handle into a Fortran handle, or vice versa. That's the whole job. Glow-up for handles. π
πΈ SYNTAX πΈ
C Syntax
#include <mpi.h>
MPI_Comm MPI_Comm_f2c(MPI_Fint comm)
MPI_Fint MPI_Comm_c2f(MPI_Comm comm)
MPI_File MPI_File_f2c(MPI_Fint file)
MPI_Fint MPI_File_c2f(MPI_File file)
MPI_Group MPI_Group_f2c(MPI Fint group)
MPI_Fint MPI_Group_c2f(MPI Group group)
MPI_Info MPI_Info_f2c(MPI_Fint info)
MPI_Fint MPI_Info_c2f(MPI_Info info)
MPI_Message MPI_Message_f2c(MPI_Fint message)
MPI_Fint MPI_Message_c2f(MPI_Message message)
MPI_Op MPI_Op_f2c(MPI_Fint op)
MPI_Fint MPI_Op_c2f(MPI_Op op)
MPI_Request MPI_Request_f2c(MPI_Fint request)
MPI_Fint MPI_Request_c2f(MPI_Request request)
MPI_Datatype MPI_Type_f2c(MPI_Fint datatype)
MPI_Fint MPI_Type_c2f(MPI_Datatype datatype)
MPI_Win MPI_Win_f2c(MPI_Fint win)
MPI_Fint MPI_Win_c2f(MPI_Win win)
π¦ DESCRIPTION π¦
So here's the tea β: when handles travel between Fortran and C, they don't just waltz across the border on their own. You use an explicit C wrapper to convert Fortran handles into C handles. That's the move. And in Fortran? There is no direct access to C handles in Fortran. None. Periodt.
The type definition MPI_Fint is provided in C for an integer of the size that matches a Fortran INTEGER; usually, MPI_Fint will be equivalent to int. Cute, right? π
The handle translation functions are provided in C to convert from a Fortran handle (which is an integer) to a C handle, and vice versa. Both directions. Equality. Balance. Main character energy on both sides. β¨
Okay, example time, because vibes alone won't save you:
- if
commis a valid Fortran handle to a communicator, thenMPI_Comm_f2creturns a valid C handle to that same communicator - if
comm = MPI_COMM_NULL(Fortran value), thenMPI_Comm_f2creturns a null C handle - if
commis an invalid Fortran handle, thenMPI_Comm_f2creturns an invalid C handle
That's it. That's the translation. No notes. π
β οΈ NOTE β οΈ
bestie, listen. This function does not return an error value. Consequently, the result of calling it beforeMPI_Initor afterMPI_Finalizeis undefined. Under. Fined. π Not "probably fine", not "it worked on my laptop" β undefined. Don't do it. π«Ά
π Copyright π
2003-2026, The Open MPI Community
and that's the whole page, bestie π Open MPI, dated Sep 10, 2026, filed squarely under MPI_REQUEST_F2C(3). go convert some handles, you got this. mwah. πβ¨πΈ
π¦ where this page comes from
- ubuntu stonking: openmpi-doc 5.0.10-6 Β· other
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms