fungsi MPI_Bcast

Menyiarkan data dari satu anggota grup ke semua anggota grup.

Sintaks

int MPIAPI MPI_Bcast(
  _Inout_  void        *buffer,
  _In_    int          count,
  _In_    MPI_Datatype datatype,
  _In_    int          root,
  _In_    MPI_Comm     comm
);

Parameter

• buffer [masuk, keluar]
  Penunjuk ke buffer data. Pada proses yang ditentukan oleh parameter akar , buffer berisi data yang akan disiarkan. Pada semua proses lain dalam communicator yang ditentukan oleh parameter comm , buffer menerima data yang disiarkan oleh proses root.

• count [in]
  Jumlah elemen data dalam buffer. Jika parameter hitungan adalah nol, bagian data pesan kosong.

• datatype [in]
  Jenis data MPI dari elemen dalam buffer kirim.

• root [in]
  Peringkat proses yang mengirim data.

• comm [in]
  Pegangan komunikator MPI_Comm.

Nilai kembali

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

Di Fortran, nilai pengembalian disimpan dalam parameter IERROR .

Fortran

    MPI_BCAST(BUFFER, COUNT, DATATYPE, ROOT, COMM, IERROR)
        <type> BUFFER(*)  
        INTEGER COUNT, DATATYPE, ROOT, COMM, IERROR

Keterangan

Tanda tangan jenis seperti yang ditentukan oleh parameter hitungan dan jenis data pada setiap proses harus sama dengan tanda tangan jenis di akar. Persyaratan ini menyiratkan bahwa jumlah data yang dikirim harus sama dengan jumlah yang diterima, pasangan-bijak antara setiap proses dan akar. MPI_Bcast dan semua rutinitas kolektif pergerakan data lainnya membuat pembatasan ini. Peta jenis yang berbeda antara pengirim dan penerima masih diizinkan.

Jika parameter comm mereferensikan intrakomunikator, fungsi MPI_Bcast menyiarkan pesan dari proses yang ditentukan ke semua proses grup yang menyertakan dirinya sendiri. Ini dipanggil oleh semua anggota grup yang menggunakan parameter yang sama. Saat dikembalikan, konten buffer akar disalin ke semua proses lainnya.

Jika parameter comm mereferensikan interkomunikator, maka panggilan melibatkan semua proses dalam interkomunikator, tetapi dengan satu grup, grup A, yang menentukan proses akar. Semua proses di grup lain, grup B, menetapkan nilai yang sama dalam parameter akar , yaitu peringkat proses akar di grup A. Proses akar menetapkan nilai MPI_ROOT dalam parameter akar . Semua proses lain dalam grup A mengatur nilai MPI_PROC_NULL dalam parameter akar . Data disiarkan dari proses root ke semua proses dalam grup B. Parameter buffer proses dalam grup B harus konsisten dengan parameter buffer proses akar.

Persyaratan

Produk	Paket Redistributable HPC Pack 2012 MS-MPI, Paket HpC Pack 2008 R2 MS-MPI Redistributable, Paket 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 Kolektif MPI

MPI_Datatype