funzione MPI_Bsend

Articolo
12/27/2023

Invia i dati a un processo specificato in modalità buffer. Questa funzione restituisce quando il buffer di invio può essere riutilizzato in modo sicuro.

Sintassi

int MPIAPI MPI_Bsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

Parametri

buf [in, facoltativo]
Puntatore al buffer che contiene i dati da inviare.
count
Numero di elementi nella matrice di buffer. Se la parte dei dati del messaggio è vuota, impostare il parametro count su 0.
datatype
Tipo di dati degli elementi nel buffer.
Dest
Classificazione del processo di destinazione all'interno del comunicatore specificato dal parametro comm .
tag
Tag di messaggio che può essere usato per distinguere tipi diversi di messaggi.
Comm
Handle per il comunicatore.

Valore restituito

Restituisce MPI_SUCCESS sull'esito positivo. In caso contrario, il valore restituito è un codice di errore.

In Fortran il valore restituito viene archiviato nel parametro IERROR .

Fortran

    MPI_BSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Commenti

Questa funzione è locale, può completare correttamente l'operazione di invio senza l'occorrenza di un'operazione di ricezione corrispondente.

Questa funzione può essere avviata se è stata pubblicata o meno un'operazione di ricezione corrispondente. Può completare l'operazione di invio prima della pubblicazione di una ricezione corrispondente. Il completamento non dipende dall'occorrenza di un'operazione di ricezione corrispondente. Se si chiama questa funzione e non viene inviata alcuna operazione di ricezione corrispondente, l'implementazione MPI deve bufferare il messaggio in uscita in modo che la chiamata di invio possa restituire.

Questa funzione restituisce un errore se è presente spazio buffer insufficiente. La quantità di spazio buffer disponibile viene controllata dall'utente usando la funzione MPI_Buffer_attach .

Requisiti

Prodotto	Pacchetto ridistribuibile HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client
Intestazione	Mpi.h; Mpif.h
Libreria	Msmpi.lib
DLL	Msmpi.dll