MPI_Group_incl, funkcja
Tworzy nową grupę zawierającą podzestaw procesów w istniejącej grupie.
Składnia
int MPIAPI MPI_Group_incl(
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 i rozmiar nowej grupy.Szeregi
Procesy, które mają zostać uwzględnione w nowej grupie.newgroup [out]
Wskaźnik do uchwytu, który reprezentuje nową grupę, która zawiera uwzględnione procesy w kolejności określonej w parametrze rangs .
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_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR
Uwagi
Ta funkcja może służyć do zmiany kolejności elementów grupy.
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 PAKIETU HHPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package lub HPC Pack 2008 Client Utilities |
Nagłówek |
Mpi.h; Mpif.h |
Biblioteka |
Msmpi.lib |
DLL |
Msmpi.dll |