MPI_Comm_compare functie

Vergelijkt twee communicator-ingangen.

Syntaxis

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

Parameters

comm1

Een ingang voor de eerste communicator om te vergelijken.

comm2

Een ingang voor de tweede communicator om te vergelijken.

result [out]

Bij terugkomst, een verwijzing naar de resultaten van de vergelijking.

De mogelijke waarden zijn.

MPI_IDENT

Geeft aan dat de twee ingangen voor hetzelfde object zijn. De handles verwijzen naar identieke groepen en contexten.

MPI_CONGRUENT

Geeft aan dat de onderliggende groepen identieke leden in dezelfde rangorde hebben. Deze communicatoren verschillen alleen per context.

MPI_SIMILAR

Geeft aan dat de onderliggende groepen identieke leden hebben, maar dat ze verschillende rangschikkingen hebben.

MPI_UNEQUAL

Geeft aan dat de ingangen voor verschillende objecten zijn.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

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

Vereisten

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliotheek	Msmpi.lib
DLL	Msmpi.dll

Zie ook

MPI Communicator-functies