MPI_Group_incl işlevi

Mevcut bir gruptaki işlemlerin bir alt kümesini içeren yeni bir grup oluşturur.

Söz dizimi

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

Parametreler

• grup
  Mevcut grup.

• n
  ranks parametresindeki öğelerin sayısı ve yeni grubun boyutu.

• Sırada
  Yeni gruba dahil edilecek işlemler.

• newgroup [out]
  Eklenen işlemleri ranks parametresinde belirtilen sırayla içeren yeni grubu temsil eden bir tanıtıcı işaretçisi.

Döndürülen değer

Başarılı MPI_SUCCESS döndürür. Aksi takdirde, dönüş değeri bir hata kodudur.

Fortran'da, dönüş değeri IERROR parametresinde depolanır.

Fortran

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

Açıklamalar

Bu işlev, bir grubun öğelerini yeniden sıralamak için kullanılabilir.

Bu yerel bir işlemdir. Farklı işlemler ayrı gruplar tanımlayabilir. İşlem, kendisini içermeyen bir grup tanımlayabilir.

MPI uygulaması sıfırdan bir grup oluşturmak için bir mekanizma sağlamaz, yalnızca mevcut gruplardan oluşturur. Diğer tüm grupların tanımlandığı temel grup , MPI_Comm_group işlevi kullanılarak alınabilir. İlk communicator MPI_COMM_WORLD ile ilişkili grup.

Gereksinimler

Ayrıca bkz.

MPI Grup İşlevleri

MPI_Comm_group