funktionen MPI_Iscatterv

Artikel
01/16/2024

Syntax

int MPIAPI MPI_Iscatterv(
  _In_opt_  const void         *sendbuf,
  _In_opt_  const int          sendcounts[],
  _In_opt_  const int          displs[],
  _In_            MPI_Datatype sendtype,
  _Out_opt_        void        *recvbuf,
  _In_            int          recvcount,
  _In_            MPI_Datatype recvtype,
  _In_            int          root,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

Parametrar

sendbuf [in, valfritt]
Pekaren till en buffert som innehåller de data som ska skickas av rotprocessen.

Den här parametern ignoreras för alla icke-rotprocesser.

Om parametern comm refererar till en intracommunicator kan du ange ett alternativ på plats genom att ange MPI_IN_PLACE i rotprocessen. Parametrarna recvcount och recvtype ignoreras. Den spridda vektorn anses fortfarande innehålla n segment, där n är gruppstorleken; segmentet som motsvarar rotprocessen flyttas inte.
sendcounts[] [in, optional]
Antalet element som ska skickas till varje process. Om sendcounts[i] är noll är datadelen av meddelandet för den processen tom.

Den här parametern ignoreras för alla icke-rotprocesser.
displs[] [in, optional]
De dataplatser som ska skickas till varje kommunikationsprocess. Varje plats i matrisen är relativ till motsvarande element i sendbuf-matrisen .

I parametermatriserna sendbuf, sendcounts och displs refererar det n:e elementet i varje matris till de data som ska skickas till n:e kommunikatorprocessen.

Den här parametern är bara viktig i rotprocessen.
sendtype [in]
Datatypen för varje element i bufferten.

Den här parametern ignoreras för alla icke-rotprocesser.
recvbuf [ut, valfritt]
Pekaren till en buffert som innehåller de data som tas emot i varje process. Antalet och datatypen för elementen i bufferten anges i parametrarna recvcount och recvtype .
recvcount [in]
Antalet element i mottagningsbufferten. Om antalet är noll är datadelen av meddelandet tom.
recvtype [in]
Datatypen för elementen i mottagningsbufferten.
root [in]
Rangordningen i sändningsprocessen inom den angivna kommunikatören.
comm [in]
Den MPI_Comm kommunikationshandtaget.
begäran [ut]
Den MPI_Request hanterar som representerar kommunikationsåtgärden.

Returvärde

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

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_ISCATTERV(SENDBUF, SENDCOUNTS, DISPLS, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNTS(*), DISPLS(*), SENDTYPE, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR

Kommentarer

Ett icke-blockerande anrop initierar en kollektiv minskningsåtgärd som måste slutföras i ett separat slutförandeanrop. När åtgärden har initierats kan den fortsätta oberoende av beräkningen eller annan kommunikation i deltagande processer. På så sätt kan icke-blockerande minskningsåtgärder minimera möjliga synkroniseringseffekter av minskningsåtgärder genom att köra dem i "bakgrunden".

Alla slutförandeanrop (t.ex. MPI_Wait) stöds för icke-blockerande minskningsåtgärder.