MPI_Improbe函式

發行項
05/24/2023

以非封鎖方式探查訊息。提供一種機制，可接收符合的特定訊息，不論探查/接收作業為何。相符的訊息會從接收佇列解除佇列，讓應用程式有機會根據非封鎖比對探查作業所傳回的資訊來決定接收訊息的方式。接著會使用 MPI_Mrecv 或 MPI_Imrecv 函式來接收相符的訊息。

語法

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

參數

來源 [in]
來源排名或 MPI_ANY_SOURCE。
標記 [in]
訊息標記或 MPI_ANY_TAG。
comm [in]
MPI communicator 控制碼。
旗標 [out]
傳回時，包含整數的指標，指出指定的來源、標記和 comm 是否相符。非零值表示參數相符。
訊息 [out]
傳回時，包含相符訊息的指標。
status [out]
傳回時，包含儲存訊息相關資訊 之MPI_Status 結構的指標。

傳回值

傳回成功 時MPI_SUCCESS 。否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 IERROR 參數中。

Fortran

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

備註

如果有可接收且符合引數來源、標記和comm所指定的模式的訊息，此函式會傳回true = 旗標。呼叫會比對在程式相同點執行MPI_Recv所收到的相同訊息，並以狀態傳回MPI_Recv所傳回的相同值。此外，它會在訊息中傳回相符訊息的控制碼。否則，呼叫會傳回旗標 = false，並將狀態和訊息保留為未定義。