Dela via


funktionen MPI_Send

Utför en standardåtgärd för att skicka och returnerar när sändningsbufferten kan återanvändas på ett säkert sätt.

Syntax

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

Parametrar

  • buf [in, valfritt]
    En pekare till bufferten som innehåller de data som ska skickas.

  • Räkna
    Antalet element i bufferten. Om datadelen i meddelandet är tom anger du parametern count till 0.

  • Datatyp
    Datatypen för elementen i bufferten.

  • Dest
    Rangordningen för målprocessen i kommunikatören som anges av comm-parametern .

  • Etiketten
    Den meddelandetagg som kan användas för att särskilja olika typer av meddelanden.

  • Comm
    Handtaget till kommunikatören.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

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

Kommentarer

Den här funktionen är inte lokal. Ett lyckat slutförande kan bero på förekomsten av en matchande mottagningsfunktion.

Den här funktionen kan returneras innan en matchande mottagningsfunktion anropas om MPI-implementeringen buffrar meddelandet. Buffertutrymmet kan dock vara otillgängligt eller så är utgående meddelanden kanske inte buffrade av prestandaskäl. Om meddelandet inte buffrats returneras inte funktionen förrän data har flyttats till den mottagande processen.

Den här funktionen kan anropas om en matchande mottagningsfunktion publiceras eller inte. Den kan slutföras innan en matchande mottagningsfunktion publiceras.

Krav

Produkt

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities

Huvud

Mpi.h; Mpif.h

Bibliotek

Msmpi.lib

DLL

Msmpi.dll

Se även

MPI punkt-till-punkt-funktioner

MPI_Bsend

MPI_Rsend

MPI_Ssend

MPI_Recv