Udostępnij za pośrednictwem


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