funktionen MPI_Group_difference

Skapar en ny grupp från skillnaden mellan två befintliga grupper.

Syntax

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

Parametrar

• group1
  Den första gruppen.

• group2
  Den andra gruppen.

• newgroup [out]
  En pekare till ett handtag som representerar en ny grupp som innehåller alla element i den första gruppen som inte finns i den andra gruppen. Funktionen returnerar MPI_GROUP_EMPTY om den nya gruppen är tom.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

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

Kommentarer

Det här är en lokal åtgärd. Olika processer kan definiera distinkta grupper. En process kan definiera en grupp som inte innehåller sig själv.

MPI-implementeringen tillhandahåller ingen mekanism för att skapa en grupp från grunden, utan bara från befintliga grupper. Basgruppen, där alla andra grupper definieras, kan hämtas med hjälp av funktionen MPI_Comm_group . Det är den grupp som är associerad med den första kommunikationsappen MPI_COMM_WORLD.

Krav

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities
Huvud	Mpi.h; Mpif.h
Bibliotek	Msmpi.lib
DLL	Msmpi.dll

Se även

MPI-gruppfunktioner

MPI_Comm_group