fungsi MPI_Type_create_subarray

Menentukan jenis data baru yang terdiri dari subarray n-dimensi dari array n-dimensi. Subarray dapat ditemukan di mana saja dalam array penuh. Ini bisa menjadi ukuran bukan nol selama sepenuhnya terkandung dalam array.

Sintaks

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
);

Parameter

ndims

Jumlah dimensi array dan jumlah elemen dalam parameter array_of_sizes, array_of_subsizes , dan array_of_starts .

array_of_sizes

Jumlah elemen di setiap dimensi array lengkap.

array_of_subsizes

Jumlah elemen di setiap dimensi subarray.

array_of_starts

Indeks awal subarray di setiap dimensi.

urutan

Urutan dimensi.

MPI_ORDER_C

Urutan utama baris di mana semua elemen untuk baris tertentu disimpan secara berdekatan.

MPI_ORDER_FORTRAN

Urutan utama kolom di mana semua elemen untuk kolom tertentu disimpan secara berdekatan.

Catatan

Program C dan Fortran dapat menggunakan salah satu pesanan. Nilai yang ditentukan mencerminkan penggunaan umum.

 

jenis lama

Menentukan jenis data dari setiap elemen.

newtype [out]

Saat kembali, berisi handel MPI_Datatype yang mewakili jenis data baru.

Nilai kembali

Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Di Fortran, nilai pengembalian disimpan dalam parameter IERROR .

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

Keterangan

Fungsi mengembalikan kesalahan jika ukuran subarray melebihi ukuran array. Untuk setiap dimensi i, nilai parameter array_of_subsizes[i] harus lebih besar dari atau sama dengan satu dan kurang dari atau sama dengan parameter array_of_sizes[i] .

Fungsi mengembalikan kesalahan jika subarray dimulai atau berakhir di luar batas array. Untuk dimensi i apa pun, nilai parameter harus nol dan jumlah parameter array_of_starts[i] dan array_of_subsizes[i] harus kurang dari atau sama dengan nilai parameter array_of_sizes[i ]. Misalnya, jika subarray berukuran sama dengan array, maka subarray harus dimulai pada nol indeks. Array diasumsikan diindeks mulai dari nol.

Persyaratan

Produk	Paket Redistributable HPC Pack 2012 MS-MPI, Paket HpC Pack 2008 R2 MS-MPI Redistributable, Paket HPC Pack 2008 MS-MPI Redistributable Package atau HpC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Pustaka	Msmpi.lib
DLL	Msmpi.dll

Lihat juga

Fungsi Tipe Data MPI