MPI_Mrecv fungsi

Artikel
12/27/2023

Melakukan penerimaan pemblokiran untuk pesan yang cocok dengan MPI_Mprobe atau MPI_Improbe.

Sintaks

int MPIAPI MPI_Mrecv(
  _Out_   void         *buf,
  _In_    int          count,
  _In_    MPI_Datatype datatype,
  _Inout_ MPI_Message  *message,
  _Out_   MPI_Status   *status
);

Parameter

buf [out]
Penunjuk ke alamat buffer penerima.
count [in]
Jumlah elemen datatype dalam buf.
datatype [in]
Jenis data MPI dari elemen dalam array buffer.
message [in, out]
Berisi penunjuk ke pesan.
status [out]
Saat dikembalikan, berisi penunjuk ke struktur MPI_Status tempat informasi tentang pesan disimpan.

Nilai kembali

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

Di Fortran, nilai yang dikembalikan disimpan dalam parameter IERROR .

Fortran

    MPI_MRECV(BUF, COUNT, DATATYPE, MESSAGE, STATUS, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

Keterangan

Fungsi ini menerima pesan yang cocok dengan operasi pemeriksaan yang cocok. Buffer penerima terdiri dari penyimpanan yang berisi jumlah elemen berturut-turut dari jenis yang ditentukan oleh jenis data, dimulai dari alamat buf. Panjang pesan yang diterima harus kurang dari atau sama dengan panjang buffer penerima. Kesalahan luapan terjadi jika semua data masuk tidak pas, tanpa pemotokan, ke dalam buffer terima.

Jika pesan lebih pendek dari buffer penerima, maka hanya lokasi yang sesuai dengan pesan (lebih pendek) yang dimodifikasi.

Saat dikembalikan dari fungsi ini, handel pesan diatur ke MPI_MESSAGE_NULL. Semua kesalahan yang terjadi selama eksekusi operasi ini ditangani sesuai dengan penangan kesalahan yang ditetapkan untuk komunikator yang digunakan dalam panggilan pemeriksaan yang cocok yang menghasilkan handel pesan