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


функция MPI_Comm_compare

Сравнивает два дескриптора коммуникатора.

Синтаксис

int MPIAPI MPI_Comm_compare(
        MPI_Comm comm1,
        MPI_Comm comm2,
  _Out_ int      *result
);

Параметры

comm1

Дескриптор для первого сравниваемого коммуникатора.

comm2

Дескриптор для сравнения второго коммуникатора.

result [out]

При возврате — указатель на результаты сравнения.

Возможные значения: .

MPI_IDENT

Указывает, что два дескриптора относятся к одному и тому же объекту. Дескриптор ссылается на идентичные группы и контексты.

MPI_CONGRUENT

Указывает, что базовые группы имеют идентичных членов в одном порядке ранжирования. Эти коммуникаторы отличаются только контекстом.

MPI_SIMILAR

Указывает, что базовые группы имеют идентичных членов, но находятся в разных порядках ранжирования.

MPI_UNEQUAL

Указывает, что дескрипторы предназначены для разных объектов.

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

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

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

Fortran

    MPI_COMM_COMPARE(COMM1,COMM2,RESULT,IERROR)
        INTEGER COMM1, COMM1, RESULT, 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