MPI_Status_f2c 函数

从 Fortran 状态 (() 整数数组)转换为 C 状态 (它是一个结构) 。 转换发生在状态中的所有信息上,包括隐藏的信息。 也就是说,转换中不会丢失任何状态信息。

语法

int MPIAPI MPI_Status_f2c(
  _In_  MPI_Fint   *f_status,
  _Out_ MPI_Status *status
);

参数

  • f_status [in]
    Fortran 状态。

  • status [out]
    C 状态。

返回值

返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。

注解

如果 f_status 是有效的 Fortran 状态,但不是 MPI_STATUS_IGNOREMPI_STATUSES_IGNORE 的 Fortran 值,则 MPI_Status_f2c 返回 c_status 具有相同内容的有效 C 状态。 如果 f_statusMPI_STATUS_IGNOREMPI_STATUSES_IGNORE 的 Fortran 值,或者 如果 f_status 不是有效的 Fortran 状态,则调用是错误的。

C 状态具有与 Fortran 状态相同的源、标记和错误代码值,并在查询计数、元素和取消时返回相同的答案。 可以使用具有未定义错误字段的 Fortran status 参数调用转换函数,在这种情况下,C 状态参数中的错误字段的值是未定义的

要求

产品

HPC Pack 2012 MS-MPI 可再发行程序包、HPC Pack 2008 R2 MS-MPI 可再发行程序包、HPC Pack 2008 MS-MPI 可再发行程序包或 HPC Pack 2008 客户端实用工具

标头

Mpi.h;Mpif.h

Msmpi.lib

DLL

Msmpi.dll

另请参阅

MPI 杂项函数