17.2.321. MPI_Session_f2c

MPI_Session_c2f, MPI_Session_f2c - 将C语言会话句柄转换为Fortran INTEGER风格的会话句柄，或反之。

17.2.321.1. 语法

17.2.321.1.1. C语法

#include <mpi.h>

int MPI_Session_f2c(const MPI_Fint *f_session, MPI_Session *c_session)
int MPI_Session_c2f(const MPI_Session *c_session, MPI_Fint *f_session)

17.2.321.2. 参数

f_session: mpi风格的INTEGER MPI会话对象
c_session: C风格的MPI会话对象

17.2.321.3. 描述

这两个C语言程序用于在Fortran会话（一个整数数组）和C会话（一个结构体）之间进行相互转换。转换过程会处理session中的所有信息，包括隐藏部分。也就是说，在转换过程中不会丢失任何会话信息。

当使用MPI_Session_f2c()时，如果f_session是一个有效的Fortran会话，那么MPI_Session_f2c()会在c_session中返回一个具有相同内容的有效C会话。如果f_session是MPI_SESSION_NULL的Fortran值，或者如果f_session不是一个有效的Fortran会话，则该调用是错误的。

使用MPI_Session_c2f()时，会进行相反的转换。如果c_session是MPI_SESSION_NULL，或者c_session不是有效的C会话，则该调用是错误的。

17.2.321.4. 注意事项

这些函数仅在C语言中可用；它们在任何Fortran MPI接口中都不可用。