Поделиться через


функция MPI_Group_excl

Конструктор группы, который используется для определения новой группы путем удаления рангов из существующей группы.

Синтаксис

int MPIAPI MPI_Group_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Параметры

  • group
    Существующая группа.

  • n
    Количество элементов в параметре рангов .

  • Ряды
    Массивы процессов в группе , которые не должны отображаться в новой группе. Указанные ранги должны быть допустимыми в существующей группе. Каждый элемент в массиве должен быть уникальным. Если массив пуст, новая группа будет идентична существующей.

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

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

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

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

Fortran

    MPI_GROUP_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Комментарии

Эта функция создает новую группу процессов, производную путем удаления указанных процессов из существующей группы с сохранением порядка рангов в группе.

Требования

Продукт

Распространяемый пакет 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