MPI_Group_range_incl 函式
群組建構函式，這個建構函式會藉由將其他排名集新增至現有群組，以定義新的群組。
語法
int MPIAPI MPI_Group_range_incl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
參數
群組
現有的群組。n
陣列範圍中的三倍數。範圍
要包含在新群組中的程式規格陣列。 陣列的每個元素都會以第一個排名、最後一個順位和進階的三個整數形式指定進程範圍。newgroup [out]
表示新群組之控制碼的指標。 新的群組包含其他一組排名。 順序是由 範圍所定義。
傳回值
傳回成功 時MPI_SUCCESS 。 否則，傳回值是錯誤碼。
在 Fortran 中，傳回值會儲存在 IERROR 參數中。
Fortran
MPI_GROUP_RANGE_INCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
備註
如果範圍是由第一個 (、last1、stride1) 、...、 (firstn 組成 lastn，striden) ，然後新群組是由排名 first1、 first1 + stride1， ...， RoundDown ( (last1 - first1) ) *stride1， ...， firstn， firstn + striden， ...， firstn + striden， ...， RoundDown ( (lastn - firstn - firstn) /striden) *striden。
每個計算排名都必須是新群組中的有效排名，而且所有計算排名都必須不同。 否則，函式會傳回錯誤。
注意
請注意，您可以設定大於 last[i]的 first[i]，而 stride[i]可以是負數，但不能是零。
這是本機作業。 不同的進程可以定義不同的群組。 進程可以定義不包含本身的群組。
MPI 實作不提供從頭開始建置群組的機制，但只提供現有群組的機制。 可以使用 MPI_Comm_group 函式來擷取所有其他群組的基底群組。 它是與初始通訊器 MPI_COMM_WORLD相關聯的群組。
規格需求
產品 |
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 |