Delen via


MPI_Group_union functie

Hiermee maakt u een nieuwe groep op basis van de samenvoeging van twee bestaande groepen.

Syntaxis

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

Parameters

  • groep1
    De eerste groep.

  • groep2
    De tweede groep.

  • newgroup [out]
    Bevat bij terugkomst een verwijzing naar een nieuwe groep die alle elementen in een van beide groepen vertegenwoordigt.

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_UNION(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 omvat.

De MPI-implementatie biedt geen mechanisme om een volledig nieuwe groep op te bouwen, maar alleen op basis van 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