funzione MPI_Send

Articolo
12/27/2023

Esegue un'operazione di invio in modalità standard e restituisce quando il buffer di invio può essere riutilizzato in modo sicuro.

Sintassi

int MPIAPI MPI_Send(
  _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 contenuti nel buffer. Se la parte 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 del messaggio che può essere usato per distinguere tipi diversi di messaggi.
Comm
Handle per il comunicatore.

Valore restituito

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

In Fortran il valore restituito viene archiviato nel parametro IERROR .

Fortran

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

Commenti

Questa funzione non è locale. Il completamento corretto può dipendere dall'esistenza di una funzione di ricezione corrispondente.

Questa funzione può restituire prima che venga richiamata una funzione di ricezione corrispondente se l'implementazione MPI memorizza nel buffer il messaggio. Tuttavia, lo spazio del buffer potrebbe non essere disponibile o i messaggi in uscita potrebbero non essere memorizzati nel buffer per motivi di prestazioni. Se il messaggio non viene memorizzato nel buffer, la funzione non restituisce finché i dati non vengono spostati nel processo di ricezione.

Questa funzione può essere chiamata indipendentemente dal fatto che venga registrata o meno una funzione di ricezione corrispondente. Potrebbe terminare prima che venga pubblicata una funzione di ricezione corrispondente.

Requisiti

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