MPI_Group_range_incl işlevi

Var olan bir gruba ek derece kümeleri ekleyerek yeni bir grup tanımlamak için kullanılan bir grup oluşturucu.

Söz dizimi

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

Parametreler

• grup
  Mevcut grup.

• n
  Dizi aralıklarındaki üçlülerin sayısı.

• Aralık
  Yeni gruba eklenecek 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]
  Yeni grubu temsil eden tanıtıcı işaretçisi. Yeni grup ek derece kümelerini içerir. Sıra aralıklarla tanımlanır.

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

Açıklamalar

Aralıklar üçüzlerden oluşuyorsa (ilk1 , son1, adım1) , ..., (firstn, lastn, striden), sonra newgroup rank first1, first1 + stride1, ..., RoundDown((last1 - first1)/stride1)*stride1, ..., firstn, firstn + striden, ..., RoundDown((lastn - firstn)/striden)*striden olan gruptaki işlemlerin dizisini oluşturur.

Hesaplanan her derece, yeni grupta geçerli bir derece olmalı ve tüm hesaplanan dereceler ayrı olmalıdır. Aksi takdirde işlev bir hata döndürür.

Not

İlk[i] değerini last[i] değerinden büyük olarak ayarlayabileceğinizi ve stride[i] öğesinin negatif olabileceğini, ancak sıfır olamayacağını unutmayın.

 

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 bir mekanizma sağlar. 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_incl

MPI_Comm_group