共用方式為


MPI_Cart_sub 函式

將 communicator 分割成形成較低維度的笛卡子網格線的子群組。

語法

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

參數

  • 通訊
    具有笛卡兒結構的 Communicator。

  • remain_dims [in]
    remain_dims的第i 個專案會指定第 i 個維度是保留在子數據格中, (true) ,還是捨棄 (false) 。

  • newcomm [out]
    包含包含呼叫進程的子rid 的 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 進程拓撲函式