Delen via


MPI_Group_excl functie

Een groepsconstructor die wordt gebruikt om een nieuwe groep te definiëren door rangschikkingen uit een bestaande groep te verwijderen.

Syntaxis

int MPIAPI MPI_Group_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Parameters

  • groep
    De bestaande groep.

  • n
    Het aantal elementen in de parameter ranks .

  • Gelederen
    De matrices van processen in groep die niet in newgroup mogen worden weergegeven. De opgegeven rangschikkingen moeten geldig zijn in de bestaande groep. Elk element in de matrix moet uniek zijn. Als de matrix leeg is, is de nieuwe groep identiek aan de bestaande groep.

  • newgroup [out]
    Een verwijzing naar een ingang die de nieuwe groep vertegenwoordigt die is afgeleid van de bestaande groep. De volgorde van de bestaande groep blijft behouden in de nieuwe groep.

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_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Opmerkingen

Met deze functie maakt u een nieuwe groep processen die wordt afgeleid door opgegeven processen uit een bestaande groep te verwijderen met behoud van de volgorde van de rangschikkingen in de groep.

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