MPI_Send, funkcja

Artykuł
05/24/2023

Wykonuje operację wysyłania w trybie standardowym i zwraca wartość, gdy bufor wysyłania może być bezpiecznie ponownie używany.

Składnia

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

Parametry

buf [in, opcjonalnie]
Wskaźnik do buforu zawierającego dane do wysłania.
Liczba
Liczba elementów w buforze. Jeśli część danych komunikatu jest pusta, ustaw parametr count na 0.
Datatype
Typ danych elementów w buforze.
Dest
Ranga procesu docelowego w programie communicator, który jest określony przez parametr comm .
Tag
Tag komunikatu, który może służyć do rozróżniania różnych typów komunikatów.
Comm
Uchwyt do komunikatora.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

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

Uwagi

Ta funkcja nie jest lokalna. Pomyślne ukończenie może zależeć od istnienia zgodnej funkcji odbierania.

Ta funkcja może zostać zwrócona przed wywołaną zgodną funkcją odbierania, jeśli implementacja MPI buforuje komunikat. Jednak miejsce buforu może być niedostępne lub komunikaty wychodzące mogą nie być buforowane ze względu na wydajność. Jeśli komunikat nie jest buforowany, funkcja nie zwraca się, dopóki dane nie zostaną przeniesione do procesu odbierania.

Tę funkcję można wywołać, czy zostanie wysłana zgodna funkcja odbierania. Może zakończyć się przed opublikowaniem zgodnej funkcji odbierania.

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll