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 |