MPI_Compare_and_swap fungsi

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