MPI_Comm_rank 函数

检索指定通信器组中调用进程的排名。

语法

int MPIAPI MPI_Comm_rank(
        MPI_Comm comm,
  _Out_ int      *rank
);

参数

  • comm
    通信器。

  • rank [out]
    返回时,指向通信器组中调用进程的标识符的指针。

返回值

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

在 Fortran 中,返回值存储在 IERROR 参数中。

Fortran

    MPI_COMM_RANK(COMM,RANK,IERROR)
        INTEGER COMM, RANK, IERROR

注解

此函数使用户能够通过单个函数调用检索进程排名。 否则,必须使用 MPI_Comm_group 函数创建一个临时组,使用 MPI_Group_rank 函数获取组中的排名,然后使用 MPI_Group_free 函数释放临时组。

要求

产品

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 Communicator 函数

MPI_Comm_size