MPI_Type_create_subarray işlevi

N boyutlu bir dizinin n boyutlu alt dizisini içeren yeni bir veri türünü tanımlar. Alt dizi, tam dizi içinde herhangi bir yerde bulunabilir. Dizide tam olarak yer aldığı sürece sıfır olmayan herhangi bir boyut olabilir.

Söz dizimi

int MPIAPI MPI_Type_create_subarray(
        int                   ndims,
        _In_count_(ndims) int array_of_sizes[],
        _In_count_(ndims) int array_of_subsizes[],
        _In_count_(ndims) int array_of_starts[],
        int                   order,
        MPI_Datatype          oldtype,
  _Out_ MPI_Datatype          *newtype
);

Parametreler

ndims

Dizi boyutlarının sayısı ve array_of_sizes, array_of_subsizes ve array_of_starts parametrelerindeki öğelerin sayısı.

array_of_sizes

Tam dizinin her boyutundaki öğelerin sayısı.

array_of_subsizes

Alt dizideki her boyuttaki öğelerin sayısı.

array_of_starts

Her boyuttaki alt dizinin başlangıç dizini.

order

Boyutların sırası.

MPI_ORDER_C

Belirli bir satır için tüm öğelerin bitişik olarak depolandığı satır-ana sıra.

MPI_ORDER_FORTRAN

Belirli bir sütun için tüm öğelerin bitişik olarak depolandığı sütun-ana sıra.

Not

Hem C hem de Fortran programları her iki sırayı da kullanabilir. Tanımlanan değerler tipik kullanımı yansıtır.

 

oldtype

Her öğenin veri türünü belirtir.

newtype [out]

Sonuç olarak, yeni veri türünü temsil eden bir MPI_Datatype tanıtıcısı içerir.

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_TYPE_CREATE_SUBARRAY(NDIMS, ARRAY_OF_SIZES, ARRAY_OF_SUBSIZES, ARRAY_OF_STARTS, ORDER, OLDTYPE, NEWTYPE, IERROR)
        NDIMS, ARRAY_OF_SIZES, ARRAY_OF_SUBSIZES, ARRAY_OF_STARTS, ORDER, OLDTYPE, NEWTYPE, IERROR

Açıklamalar

Alt dizi boyutunun dizinin boyutunu aşması durumunda işlev bir hata döndürür. Her boyut i için , array_of_subsizes[i] parametresinin değeri bire eşit veya daha büyük ve array_of_sizes[i] parametresine eşit veya ondan küçük olmalıdır.

Alt dizi dizi sınırları dışında başlarsa veya biterse işlev bir hata döndürür. Herhangi bir boyut i için parametrenin değeri sıfır, array_of_starts[i] ve array_of_subsizes[i] parametrelerinin toplamı array_of_sizes[i] parametresinin değerinden küçük veya buna eşit olmalıdır. Örneğin, alt dizi diziyle aynı boyuttaysa, alt dizi sıfır dizininden başlamalıdır. Dizilerin sıfırdan başlayarak dizine alınacağı varsayılır.

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 Veri Türü İşlevleri