MPI_Group_excl, funkcja

Konstruktor grupy używany do definiowania nowej grupy przez usunięcie szeregów z istniejącej grupy.

Składnia

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

Parametry

• Grupa
  Istniejąca grupa.

• n
  Liczba elementów w parametrze ranks .

• Szeregi
  Tablice procesów w grupie , które nie mają być wyświetlane w nowej grupie. Określone rangi muszą być prawidłowe w istniejącej grupie. Każdy element w tablicy musi być odrębny. Jeśli tablica jest pusta, nowa grupa będzie identyczna z istniejącą grupą.

• newgroup [out]
  Wskaźnik do uchwytu, który reprezentuje nową grupę, która pochodzi z istniejącej grupy. Kolejność istniejącej grupy jest zachowywana w nowej grupie.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

    MPI_GROUP_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Uwagi

Ta funkcja tworzy nową grupę procesów pochodnych przez usunięcie określonych procesów z istniejącej grupy przy zachowaniu kolejności szeregów w grupie.

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

Funkcje grupy MPI