fungsi MPI_Improbe

Artikel
12/27/2023

Pemeriksaan untuk pesan dengan cara yang tidak memblokir. Menyediakan mekanisme untuk menerima pesan tertentu yang cocok terlepas dari intervensi operasi pemeriksaan/penerimaan. Pesan yang cocok tidak diantrekan dari antrean terima, memberi aplikasi kesempatan untuk memutuskan cara menerima pesan berdasarkan informasi yang dikembalikan oleh operasi pemeriksaan yang tidak cocok. Pesan yang cocok kemudian diterima menggunakan fungsi MPI_Mrecv atau MPI_Imrecv .

Sintaks

int MPIAPI MPI_Improbe(
  _In_  int         source,
  _In_  int         tag,
  _In_  MPI_Comm    comm,
  _Out_ Int         *flag,
  _Out_ MPI_Message *message,
  _Out_ MPI_Status  *status
);

Parameter

source [in]
Peringkat sumber atau MPI_ANY_SOURCE.
tag [in]
Tag pesan atau MPI_ANY_TAG.
comm [in]
Handel komunikator MPI.
flag [out]
Saat kembali, berisi penunjuk ke bilangan bulat yang menunjukkan apakah sumber, tag, dan comm yang ditentukan cocok. Nilai bukan nol menunjukkan bahwa parameter cocok.
message [out]
Saat kembali, berisi penunjuk ke pesan yang cocok.
status [out]
Saat kembali, 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 pengembalian disimpan dalam parameter IERROR .

Fortran

    MPI_IMPROBE(SOURCE, TAG, COMM, FLAG, MESSAGE, STATUS, IERROR)
          INTEGER SOURCE, TAG, COMM, FLAG, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

Keterangan

Fungsi ini mengembalikan bendera = true jika ada pesan yang dapat diterima dan yang cocok dengan pola yang ditentukan oleh sumber argumen, tag, dan comm. Panggilan cocok dengan pesan yang sama yang akan diterima oleh panggilan ke MPI_Recv dijalankan pada titik yang sama dalam program dan mengembalikan status nilai yang sama yang akan dikembalikan oleh MPI_Recv. Selain itu, ia kembali dalam pesan handel ke pesan yang cocok. Jika tidak, panggilan mengembalikan bendera = false dan membuat status dan pesan tidak terdefinisi.