MPI_Iallgather függvény

Adatokat gyűjt a csoport összes tagjától, és nem blokkoló módon küldi el az adatokat a csoport összes tagjának.

Szintaxis

int MPIAPI MPI_Iallgather(
  _In_opt_  const void         *sendbuf,
  _In_             int         sendcount,
  _In_            MPI_Datatype sendtype,
  _Out_opt_       void         *recvbuf,
  _In_            int          recvcount,
  _In_            MPI_Datatype recvtype,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

Paraméterek

• sendbuf [in, nem kötelező]
  A csoport összes folyamatának elküldendő adatokra mutató mutató. A puffer elemeinek száma és adattípusa a sendcount és a sendtype paraméterekben van megadva. A puffer minden eleme megfelel a csoport egy folyamatának.

  Ha a komm paraméter egy intrakommunikátorra hivatkozik, a MPI_IN_PLACE minden folyamathoz megadhat egy helyi beállítást. A sendcount és a sendtype paraméterek figyelmen kívül lesznek hagyva. Minden folyamat adatokat ad meg a megfelelő fogadási pufferelemben. Az n. folyamat adatokat küld a fogadópuffer n. elemének.

• sendcount [in]
  A sendbuf paraméterben megadott elemek száma a pufferben. Ha a sendcount értéke nulla, az üzenet adatrésze üres.

• sendtype [in]
  A küldési puffer elemeinek MPI-adattípusa.

• recvbuf [ki, nem kötelező]
  Az egyes folyamatoktól kapott adatokat tartalmazó pufferre mutató mutató. A puffer elemeinek száma és adattípusa a recvcount és a recvtype paraméterekben van megadva.

• recvcount [in]
  A fogadó puffer elemeinek száma. Ha a szám nulla, az üzenet adatrésze üres.

• recvtype [in]
  A fogadó puffer elemeinek MPI-adattípusa.

• comm [in]
  A MPI_Comm communicator leírója.

• request [out]
  A kommunikációs műveletet jelképező MPI_Request leíró.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben lesz tárolva.

Fortran

    MPI_IALLGATHER(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR

Megjegyzések

A nem blokkoló hívás együttes csökkentési műveletet kezdeményez, amelyet külön befejezési hívásban kell végrehajtani. A kezdeményezést követően a művelet a részt vevő folyamatokban végzett számításoktól vagy más kommunikációtól függetlenül is továbbhaladhat. Ily módon a nem blokkoló csökkentési műveletek a "háttérben" futtatva mérsékelhetik a csökkentési műveletek lehetséges szinkronizálási hatásait.

Minden befejezési hívás (például MPI_Wait) támogatott a nem blokkoló csökkentési műveletekhez.

Követelmények

Termék	Microsoft MPI v7
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI kollektív függvények

MPI_Gather

MPI_Datatype

MPI_Test

MPI_Testall

MPI_Testany

MPI_Testsome

MPI_Wait

MPI_Waitall

MPI_Waitany

MPI_Waitsome