MPI_Group_range_excl (Fungsi MPI_Group_range_excl)

Membuat grup baru dengan menghapus proses dari grup yang sudah ada.

Sintaks

int MPIAPI MPI_Group_range_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int ranges[][3],
  _Out_ MPI_Group         *newgroup
);

Parameter

• grup
  Grup yang ada.

• n
  Jumlah rentang proses yang akan dikecualikan dari grup baru.

• Rentang
  Array spesifikasi proses yang akan dikecualikan dari grup yang ada. Setiap elemen array menentukan rentang proses dalam bentuk tiga bilangan bulat untuk peringkat pertama, peringkat terakhir, dan langkah.

• newgroup [out]
  Penunjuk ke handel yang mewakili grup baru yang berisi proses yang tidak dikecualikan. Urutan grup dipertahankan.

Menampilkan nilai

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

Di Fortran, nilai pengembalian disimpan dalam parameter IERROR .

Fortran

    MPI_GROUP_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR

Keterangan

Setiap peringkat komputasi harus berupa peringkat yang valid dalam grup yang ada dan semua peringkat komputasi harus berbeda; jika tidak, fungsi mengembalikan kesalahan.

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

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 Grup MPI

MPI_Group_excl

MPI_Comm_group