MPI_Comm_compare, funkcja

Porównuje dwa uchwyty komunikatora.

Składnia

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

Parametry

comm1

Uchwyt dla pierwszego komunikatora do porównania.

comm2

Uchwyt dla drugiego komunikatora do porównania.

result [out]

Po powrocie wskaźnik do wyników porównania.

Możliwe wartości to.

MPI_IDENT

Wskazuje, że dwa uchwyty są dla tego samego obiektu. Uchwyty odwołują się do identycznych grup i kontekstów.

MPI_CONGRUENT

Wskazuje, że grupy bazowe mają identyczne elementy członkowskie w tej samej kolejności rangi. Te komunikatory różnią się tylko kontekstem.

MPI_SIMILAR

Wskazuje, że grupy bazowe mają identyczne elementy członkowskie, ale są w różnych kolejności klasyfikacji.

MPI_UNEQUAL

Wskazuje, że uchwyty są przeznaczone dla różnych obiektów.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

    MPI_COMM_COMPARE(COMM1,COMM2,RESULT,IERROR)
        INTEGER COMM1, COMM1, RESULT, IERROR

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

MPI Communicator Functions