функция MPI_Group_union

Создает новую группу из объединения двух существующих групп.

Синтаксис

int MPIAPI MPI_Group_union(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

Параметры

• group1
  Первая группа.

• group2
  Вторая группа.

• newgroup [out]
  При возврате содержит указатель на новую группу, представляющую все элементы в любой из групп.

Возвращаемое значение

Возвращает MPI_SUCCESS при успешном выполнении. В противном случае возвращаемое значение представляет собой код ошибки.

В Fortran возвращаемое значение хранится в параметре IERROR .

Fortran

    MPI_GROUP_UNION(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

См. также раздел

Функции группы MPI

MPI_Comm_group