MPI_Group_incl fungsi

Membuat grup baru yang berisi subset proses dalam grup yang sudah ada.

Sintaks

int MPIAPI MPI_Group_incl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Parameter

• grup
  Grup yang ada.

• n
  Jumlah elemen dalam parameter peringkat dan ukuran grup baru.

• Peringkat
  Proses yang akan disertakan dalam grup baru.

• newgroup [out]
  Penunjuk ke handel yang mewakili grup baru, yang berisi proses yang disertakan dalam urutan yang ditentukan dalam parameter peringkat .

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_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Keterangan

Fungsi ini dapat digunakan untuk menyusun ulang elemen grup.

Ini adalah operasi lokal. Proses yang berbeda dapat menentukan grup yang berbeda. Proses dapat menentukan grup yang tidak menyertakan dirinya sendiri.

Implementasi MPI tidak menyediakan mekanisme untuk membangun grup dari awal, tetapi hanya dari grup yang ada. Grup dasar, di mana semua grup lain didefinisikan, dapat diambil dengan menggunakan fungsi MPI_Comm_group . Ini adalah grup yang terkait dengan MPI_COMM_WORLD komunikator awal.

Persyaratan

Lihat juga

Fungsi Grup MPI

MPI_Comm_group