функция MPI_Group_difference
Создает новую группу на основе разницы между двумя существующими группами.
Синтаксис
int MPIAPI MPI_Group_difference(
MPI_Group group1,
MPI_Group group2,
_Out_ MPI_Group *newgroup
);
Параметры
group1
Первая группа.group2
Вторая группа.newgroup [out]
Указатель на дескриптор, представляющий новую группу, содержащую все элементы в первой группе, которых нет во второй группе. Функция возвращает MPI_GROUP_EMPTY , если новая группа пуста.
Возвращаемое значение
Возвращает MPI_SUCCESS об успешном выполнении. В противном случае возвращаемое значение является кодом ошибки.
В Fortran возвращаемое значение хранится в параметре IERROR .
Fortran
MPI_GROUP_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
INTEGER GROUP1, GROUP2, NEWGROUP, IERROR
Комментарии
Это локальная операция. Различные процессы могут определять различные группы. Процесс может определить группу, которая не включает себя.
Реализация MPI не предоставляет механизм для создания группы с нуля, а только из существующих групп. Базовую группу, в которой определены все остальные группы, можно получить с помощью функции MPI_Comm_group . Это группа, связанная с начальным MPI_COMM_WORLD коммуникатора.
Требования
Продукт |
Распространяемый пакет HPC 2012 MS-MPI, пакет HPC 2008 R2 распространяемый пакет MS-MPI, пакет HPC 2008 MS-MPI распространяемый пакет или служебные программы клиента ПАКЕТА HPC 2008 |
Заголовок |
Mpi.h; Mpif.h |
Библиотека |
Msmpi.lib |
DLL |
Msmpi.dll |