MPI_Group_difference, funkcja
Tworzy nową grupę na podstawie różnicy między dwiema istniejącymi grupami.
Składnia
int MPIAPI MPI_Group_difference(
MPI_Group group1,
MPI_Group group2,
_Out_ MPI_Group *newgroup
);
Parametry
grupa1
Pierwsza grupa.group2
Druga grupa.newgroup [out]
Wskaźnik do uchwytu, który reprezentuje nową grupę zawierającą wszystkie elementy w pierwszej grupie, które nie znajdują się w drugiej grupie. Funkcja zwraca MPI_GROUP_EMPTY , jeśli nowa grupa jest pusta.
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_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
INTEGER GROUP1, GROUP2, NEWGROUP, IERROR
Uwagi
Jest to operacja lokalna. Różne procesy mogą definiować różne grupy. Proces może definiować grupę, która nie zawiera się.
Implementacja mpI nie zapewnia mechanizmu tworzenia grupy od podstaw, ale tylko z istniejących grup. Grupę bazową, na której zdefiniowano wszystkie inne grupy, można pobrać za pomocą funkcji MPI_Comm_group . Jest to grupa skojarzona z początkowym komunikatorem MPI_COMM_WORLD.
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 |