funktionen MPI_Group_excl

En gruppkonstruktor som används för att definiera en ny grupp genom att ta bort rangordningar från en befintlig grupp.

Syntax

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

Parametrar

• grupp
  Den befintliga gruppen.

• n
  Antalet element i rangparametern .

• Rangordnar
  Matriserna med processer i gruppen som inte ska visas i newgroup. De angivna rangordningarna måste vara giltiga i den befintliga gruppen. Varje element i matrisen måste vara distinkt. Om matrisen är tom blir den nya gruppen identisk med den befintliga gruppen.

• newgroup [out]
  En pekare till en referens som representerar den nya gruppen som härleds från den befintliga gruppen. Ordningen på den befintliga gruppen bevaras i den nya gruppen.

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

Kommentarer

Den här funktionen skapar en ny grupp processer som härleds genom att ta bort angivna processer från en befintlig grupp samtidigt som rangordningen i gruppen bevaras.

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