MPI_Send functie

Artikel
12/27/2023

Voert een standaard verzendbewerking uit en retourneert wanneer de verzendbuffer veilig opnieuw kan worden gebruikt.

Syntaxis

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

Parameters

buf [in, optioneel]
Een aanwijzer naar de buffer die de gegevens bevat die moeten worden verzonden.
Tellen
Het aantal elementen in de buffer. Als het gegevensgedeelte van het bericht leeg is, stelt u de parameter count in op 0.
Datatype
Het gegevenstype van de elementen in de buffer.
Dest
De positie van het doelproces binnen de communicator die is opgegeven door de parameter comm .
Tag
De berichttag die kan worden gebruikt om verschillende typen berichten te onderscheiden.
Comm
Het handvat voor de communicator.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

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

Opmerkingen

Deze functie is niet-lokaal. Een geslaagde voltooiing kan afhankelijk zijn van het bestaan van een overeenkomende ontvangstfunctie.

Deze functie kan worden geretourneerd voordat een overeenkomende ontvangstfunctie wordt aangeroepen als de MPI-implementatie het bericht buffert. Bufferruimte is echter mogelijk niet beschikbaar of uitgaande berichten worden mogelijk niet gebufferd om prestatieredenen. Als het bericht niet is gebufferd, wordt de functie pas geretourneerd als de gegevens naar het ontvangende proces zijn verplaatst.

Deze functie kan worden aangeroepen, ongeacht of er een overeenkomende ontvangstfunctie wordt geboekt. Het kan worden voltooid voordat een overeenkomende ontvangstfunctie wordt gepost.

Vereisten

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliotheek	Msmpi.lib
DLL	Msmpi.dll