MPI_Comm_size 函数
检索通信器中涉及的进程数或可用进程总数。
语法
int MPIAPI MPI_Comm_size(
MPI_Comm comm,
_Out_ int *size
);
参数
comm
要评估的通信器。 指定 MPI_COMM_WORLD 常量以检索可用进程的总数。size [out]
返回时,指示通信器组中的进程数。
返回值
返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。
在 Fortran 中,返回值存储在 IERROR 参数中。
Fortran
MPI_COMM_SIZE(COMM,SIZE,IERROR)
INTEGER COMM, SIZE, IERROR
注解
此函数使用户能够通过单个函数调用来检索组大小。 否则,必须使用 MPI_Comm_group 函数创建一个临时组,使用 MPI_Group_size 函数获取该组的大小,然后使用 MPI_Group_free 函数释放临时组。
此函数通常与 MPI_Comm_rank 函数一起使用,以确定可用于特定库或程序的并发量。 MPI_Comm_rank 函数指示在 0 到 size-1 范围内调用它的进程的排名,其中 size 是使用 MPI_Comm_size 函数检索的。
注意
初始化后,没有标准的方法来更改进程数。
要求
产品 |
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 |