MPI_Group_range_excl函式
從現有群組移除進程，以建立新的群組。
語法
int MPIAPI MPI_Group_range_excl(
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_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
備註
每個計算排名都必須是現有群組中的有效排名，而且所有計算排名都必須不同;否則函式會傳回錯誤。
這是本機作業。 不同的進程可以定義不同的群組。 進程可以定義不包含本身的群組。
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 |