funzione MPI_Fetch_and_op

Esegue la scrittura di lettura atomica su un elemento di dati e restituisce l'elemento dati prima dell'operazione di accumulamento.

Sintassi

int MPIAPI MPI_Fetch_and_op(
  _In_  void         *origin_addr,
  _Out_ void         *result_addr,
        MPI_Datatype datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        MPI_Op       op,
        MPI_Win      win
);

Parametri

• origin_addr [in]
  indirizzo iniziale del buffer

• result_addr [out]
  indirizzo iniziale del buffer dei risultati

• datatype
  tipo di dati di ogni voce in origine, risultato e buffer di destinazione

• target_rank
  classificazione della destinazione

• target_disp
  spostamento dall'inizio della finestra all'inizio del buffer di destinazione

• Op
  ridurre l'operazione

• Vincere
  oggetto window

Valore restituito

Restituisce MPI_SUCCESS sull'esito positivo. In caso contrario, il valore restituito è un codice di errore.

In Fortran il valore restituito viene archiviato nel parametro IERROR .

Fortran

    MPI_FETCH_AND_OP(ORIGIN_ADDR, RESULT_ADDR, DATATYPE,
                TARGET_RANK, TARGET_DISP, OP, WIN, IERROR)
        <type> ORIGIN_ADDR(*), RESULT_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER DATATYPE, TARGET_RANK, OP, WIN, IERROR

Commenti

Accumulare un elemento di tipo datatype dal buffer di origine (origin_addr) al buffer in corrispondenza dell'offset target_disp, nella finestra di destinazione specificata da target_rank e win, usando l'opzione operazione e restituire nel buffer dei risultati result_addr il contenuto del buffer di destinazione prima dell'accumulo.

I buffer di origine e risultato (origin_addr e result_addr) devono essere disgiunti. È possibile specificare una delle operazioni predefinite per MPI_Reduce, nonché MPI_NO_OP o MPI_REPLACE, come op; Le funzioni definite dall'utente non possono essere usate. L'argomento datatype deve essere un tipo di dati predefinito. L'operazione viene eseguita atomicamente.

Requisiti

Prodotto	Pacchetto ridistribuibile HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client
Intestazione	Mpi.h; Mpif.h
Libreria	Msmpi.lib
DLL	Msmpi.dll

Vedi anche

Funzioni di comunicazione mpI One-Sided