MPI_Group_range_excl işlevi

Mevcut bir gruptan işlemleri kaldırarak yeni bir grup oluşturur.

Söz dizimi

int MPIAPI MPI_Group_range_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int ranges[][3],
  _Out_ MPI_Group         *newgroup
);

Parametreler

• grup
  Mevcut grup.

• n
  Yeni grubun dışında tutulacak işlem aralıklarının sayısı.

• Aralık
  Mevcut gruptan dışlanması gereken işlem belirtimleri dizisi. Dizinin her öğesi, ilk derece, son derece ve adım için üç tamsayı biçiminde bir işlem aralığı belirtir.

• newgroup [out]
  Dışlamayan işlemleri içeren yeni grubu temsil eden bir tanıtıcı işaretçisi. Grubun sırası korunur.

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_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR

Açıklamalar

Hesaplanan her derece mevcut grupta geçerli bir derece olmalı ve tüm hesaplanan derecelendirmeler ayrı olmalıdır; aksi takdirde işlev bir hata döndürür.

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

Ürün	HPC Pack 2012 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 R2 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 MS-MPI Yeniden Dağıtılabilir Paketi veya HPC Pack 2008 İstemci Yardımcı Programları
Üst bilgi	Mpi.h; Mpif.h
Kitaplık	Msmpi.lib
DLL	Msmpi.dll

Ayrıca bkz.

MPI Grup İşlevleri

MPI_Group_excl

MPI_Comm_group