MPI_Fetch_and_op (Fungsi MPI_Fetch_and_op)

Melakukan atom baca-modifikasi-tulis pada satu elemen data, dan mengembalikan elemen data sebelum operasi akumulasi.

Sintaks

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
);

Parameter

• origin_addr [in]
  alamat awal buffer

• result_addr [out]
  alamat awal buffer hasil

• Datatype
  jenis data dari setiap entri dalam asal, buffer hasil dan target

• target_rank
  peringkat target

• target_disp
  perpindahan dari awal jendela ke awal buffer target

• Op
  kurangi operasi

• Menang
  objek jendela

Nilai kembali

Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Di Fortran, nilai yang dikembalikan disimpan dalam parameter 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

Keterangan

Akumulasi satu elemen jenis jenis datatype dari buffer asal (origin_addr) ke buffer saat offset target_disp, di jendela target yang ditentukan oleh target_rank dan menang, menggunakan operasi op dan kembali dalam buffer hasil result_addr konten buffer target sebelum akumulasi.

Buffer asal dan hasil (origin_addr dan result_addr) harus terputus-putus. Salah satu operasi yang telah ditentukan sebelumnya untuk MPI_Reduce, serta MPI_NO_OP atau MPI_REPLACE, dapat ditentukan sebagai op; fungsi yang ditentukan pengguna tidak dapat digunakan. Argumen datatype harus berupa tipe data yang telah ditentukan sebelumnya. Operasi ini dijalankan secara atomik.

Persyaratan

Produk	Paket HPC Pack 2012 MS-MPI Redistributable, HpC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package atau HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Pustaka	Msmpi.lib
DLL	Msmpi.dll

Lihat juga

Fungsi Komunikasi One-Sided MPI