MPI_Compare_and_swap fungsi

Artikel
09/28/2023

Melakukan operasi perbandingan dan pertukaran atom jarak jauh.

Sintaks

int MPIAPI MPI_Compare_and_swap(
  _In_  void         *origin_addr,
  _In_  void         *compare_addr,
  _Out_ void         *result_addr,
        MPI_Datatype datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        MPI_Win      win
);

Parameter

origin_addr [in]
alamat awal buffer
compare_addr [in]
alamat awal comparebuffer
result_addr [out]
alamat awal buffer hasil
Datatype
jenis data dari setiap entri di semua buffer
target_rank
peringkat target
target_disp
perpindahan dari awal jendela ke awal buffer target
Menang
objek jendela

Mengembalikan nilai

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

Di Fortran, nilai yang dikembalikan disimpan dalam parameter IERROR .

Fortran

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

Keterangan

Fungsi ini membandingkan satu elemen jenis jenis datatype dalam buffer perbandingan compare_addr dengan buffer pada offset target_disp di jendela target yang ditentukan oleh target_rank dan menang dan mengganti nilai pada target dengan nilai dalam buffer asal origin_addr jika buffer bandingkan dan buffer target identik. Nilai asli pada target dikembalikan dalam result_addr buffer. Jenis data parameter harus termasuk dalam salah satu kategori jenis data yang telah ditentukan sebelumnya berikut: bilangan bulat C, bilangan bulat Fortran, Logis, Jenis multibahasa, atau Byte. Buffer asal dan hasil (origin_addr dan result_addr) harus terputus-putus.

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

Bagikan melalui