MPI_Cart_sub 函数

将通信器分区为构成下维笛卡尔子网格的子组。

语法

int MPIAPI MPI_Cart_sub(
        MPI_Comm comm,
  _In_  int      *remain_dims,
  _Out_ MPI_Comm *newcomm
);

参数

  • comm
    具有笛卡尔结构的通信器。

  • remain_dims [in]
    remain_dims 的第 i 个条目指定第 i 个维度是保留在子网格中, (true) 还是删除 (false) 。

  • newcomm [out]
    包含包含调用进程的子网格的 Communicator。

返回值

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

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

Fortran

    MPI_CART_SUB(COMM, REMAIN_DIMS, NEWCOMM, IERROR)
        INTEGER COMM, NEWCOMM, IERROR
        LOGICAL REMAIN_DIMS(*)

要求

产品

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 进程拓扑函数