기존 그룹에서 프로세스를 제거하여 새 그룹을 만듭니다.
구문
int MPIAPI MPI_Group_range_excl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
매개 변수
group
기존 그룹입니다.n
새 그룹에서 제외할 프로세스 범위의 수입니다.범위
기존 그룹에서 제외할 프로세스 사양의 배열입니다. 배열의 각 요소는 첫 번째 순위, 마지막 순위 및 보폭에 대한 3개의 정수 형식으로 프로세스 범위를 지정합니다.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 |