Delen via


MPI_Group_intersection functie

Hiermee maakt u een nieuwe groep op basis van het snijpunt van twee bestaande groepen.

Syntaxis

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

Parameters

  • groep1
    De eerste groep.

  • groep2
    De tweede groep.

  • newgroup [uit]
    Een aanwijzer naar een greep die een nieuwe groep vertegenwoordigt met de elementen die aanwezig zijn in beide groepen. De functie retourneert MPI_GROUP_EMPTY als de nieuwe groep leeg is.

Retourwaarde

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

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_GROUP_INTERSECTION(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

Opmerkingen

Dit is een lokale bewerking. Verschillende processen kunnen afzonderlijke groepen definiƫren. Een proces kan een groep definiƫren die zichzelf niet opneemt.

De MPI-implementatie biedt geen mechanisme om een volledig nieuwe groep te bouwen, maar alleen vanuit bestaande groepen. De basisgroep, waarop alle andere groepen zijn gedefinieerd, kan worden opgehaald met behulp van de functie MPI_Comm_group . Het is de groep die is gekoppeld aan de eerste communicator MPI_COMM_WORLD.

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-groepsfuncties

MPI_Comm_group