Kelas task_group

Kelas task_group mewakili kumpulan pekerjaan paralel yang dapat ditunggu atau dibatalkan.

Sintaks

class task_group;

Anggota

Konstruktor Publik

Nama	Deskripsi
task_group	Kelebihan beban. Membuat objek baru task_group .
~task_group Destructor	Menghancurkan objek task_group . Anda diharapkan untuk memanggil wait metode atau run_and_wait pada objek sebelum destruktor yang dijalankan, kecuali destruktor dijalankan sebagai hasil dari pelepasan tumpukan karena pengecualian.

Metode Publik

Nama	Deskripsi
batalkan	Lakukan upaya terbaik untuk membatalkan sub-pohon pekerjaan yang berakar pada grup tugas ini. Setiap tugas yang dijadwalkan pada grup tugas akan dibatalkan secara transitif jika memungkinkan.
is_canceling	Menginformasikan pemanggil apakah grup tugas saat ini berada di tengah pembatalan atau tidak. Ini tidak selalu menunjukkan bahwa cancel metode dipanggil pada task_group objek (meskipun metode tersebut tentu memenuhi syarat untuk mengembalikan truemetode ini ). Mungkin saja task_group objek menjalankan sebaris dan grup tugas lebih lanjut di pohon kerja dibatalkan. Dalam kasus seperti ini di mana runtime dapat menentukan sebelumnya bahwa pembatalan akan mengalir melalui objek ini task_group , true akan dikembalikan juga.
jalankan	Kelebihan beban. Menjadwalkan tugas pada task_group objek. task_handle Jika objek diteruskan sebagai parameter ke run, pemanggil bertanggung jawab untuk mengelola masa task_handle pakai objek. Versi metode yang mengambil referensi ke objek fungsi sebagai parameter melibatkan alokasi timbunan di dalam runtime yang mungkin berkinerja kurang baik daripada menggunakan versi yang mengambil referensi ke task_handle objek. Versi yang mengambil parameter _Placement menyebabkan tugas menjadi bias untuk dieksekusi di lokasi yang ditentukan oleh parameter tersebut.
run_and_wait	Kelebihan beban. Menjadwalkan tugas yang akan dijalankan sebaris pada konteks panggilan dengan bantuan task_group objek untuk dukungan pembatalan penuh. Fungsi kemudian menunggu hingga semua pekerjaan pada task_group objek telah selesai atau dibatalkan. task_handle Jika objek diteruskan sebagai parameter ke run_and_wait, pemanggil bertanggung jawab untuk mengelola masa task_handle pakai objek.
Tunggu	Menunggu hingga semua pekerjaan pada task_group objek selesai atau dibatalkan.

Keterangan

Tidak seperti kelas yang sangat dibatasi structured_task_group , task_group kelas ini jauh lebih umum. Ini tidak memiliki batasan apa pun yang dijelaskan oleh structured_task_group. task_group objek dapat digunakan dengan aman di seluruh utas dan digunakan dengan cara bentuk bebas. Kerugian dari task_group konstruksi adalah bahwa ia mungkin tidak melakukan serta structured_task_group konstruksi untuk tugas yang melakukan sejumlah kecil pekerjaan.

Untuk informasi selengkapnya, lihat Paralelisme Tugas.

Hierarki Warisan

task_group

Persyaratan

Header: ppl.h

Namespace: konkurensi

batalkan

Lakukan upaya terbaik untuk membatalkan sub-pohon pekerjaan yang berakar pada grup tugas ini. Setiap tugas yang dijadwalkan pada grup tugas akan dibatalkan secara transitif jika memungkinkan.

void cancel();

Keterangan

Untuk informasi selengkapnya, lihat Pembatalan.

is_canceling

Menginformasikan pemanggil apakah grup tugas saat ini berada di tengah pembatalan atau tidak. Ini tidak selalu menunjukkan bahwa cancel metode dipanggil pada task_group objek (meskipun metode tersebut tentu memenuhi syarat untuk mengembalikan truemetode ini ). Mungkin saja task_group objek menjalankan sebaris dan grup tugas lebih lanjut di pohon kerja dibatalkan. Dalam kasus seperti ini di mana runtime dapat menentukan sebelumnya bahwa pembatalan akan mengalir melalui objek ini task_group , true akan dikembalikan juga.

bool is_canceling();

Tampilkan Nilai

Indikasi apakah task_group objek berada di tengah pembatalan (atau dijamin segera).

Keterangan

Untuk informasi selengkapnya, lihat Pembatalan.

jalankan

Menjadwalkan tugas pada task_group objek. task_handle Jika objek diteruskan sebagai parameter ke run, pemanggil bertanggung jawab untuk mengelola masa task_handle pakai objek. Versi metode yang mengambil referensi ke objek fungsi sebagai parameter melibatkan alokasi timbunan di dalam runtime yang mungkin berkinerja kurang baik daripada menggunakan versi yang mengambil referensi ke task_handle objek. Versi yang mengambil parameter _Placement menyebabkan tugas menjadi bias untuk dieksekusi di lokasi yang ditentukan oleh parameter tersebut.

template<
   typename _Function
>
void run(
   const _Function& _Func
);

template<
   typename _Function
>
void run(
   const _Function& _Func,
   location& _Placement
);

template<
   typename _Function
>
void run(
   task_handle<_Function>& _Task_handle
);

template<
   typename _Function
>
void run(
   task_handle<_Function>& _Task_handle,
   location& _Placement
);

Parameter

_Fungsi
Jenis objek fungsi yang akan dipanggil untuk menjalankan isi handel tugas.

_Func
Fungsi yang akan dipanggil untuk memanggil isi tugas. Ini mungkin ekspresi lambda atau objek lain yang mendukung versi operator panggilan fungsi dengan tanda tangan void operator()().

_Penempatan
Referensi ke lokasi tempat tugas yang diwakili oleh _Func parameter harus dijalankan.

_Task_handle
Handel ke pekerjaan yang sedang dijadwalkan. Perhatikan bahwa penelepon memiliki tanggung jawab atas masa pakai objek ini. Runtime akan terus mengharapkannya hidup sampai wait metode atau run_and_wait telah dipanggil pada objek ini task_group .

Keterangan

Runtime menjadwalkan fungsi kerja yang disediakan untuk dijalankan di lain waktu, yang dapat setelah fungsi panggilan kembali. Metode ini menggunakan objek task_handle untuk menyimpan salinan fungsi kerja yang disediakan. Oleh karena itu, setiap perubahan status yang terjadi dalam objek fungsi yang Anda teruskan ke metode ini tidak akan muncul di salinan objek fungsi tersebut. Selain itu, pastikan bahwa masa pakai objek apa pun yang Anda lewati oleh penunjuk atau dengan referensi ke fungsi kerja tetap valid hingga fungsi kerja kembali.

task_group Jika destructs sebagai hasil dari stack unwinding dari pengecualian, Anda tidak perlu menjamin bahwa panggilan telah dilakukan ke wait metode atau run_and_wait . Dalam hal ini, destruktor akan dengan tepat membatalkan dan menunggu tugas yang _Task_handle diwakili oleh parameter selesai.

Metode ini melemparkan pengecualian invalid_multiple_scheduling jika handel tugas yang diberikan oleh _Task_handle parameter telah dijadwalkan ke objek grup tugas melalui run metode dan belum ada panggilan intervensi ke metode atau run_and_wait pada grup tugas tersebutwait.

run_and_wait

Menjadwalkan tugas yang akan dijalankan sebaris pada konteks panggilan dengan bantuan task_group objek untuk dukungan pembatalan penuh. Fungsi kemudian menunggu hingga semua pekerjaan pada task_group objek telah selesai atau dibatalkan. task_handle Jika objek diteruskan sebagai parameter ke run_and_wait, pemanggil bertanggung jawab untuk mengelola masa task_handle pakai objek.

template<
   class _Function
>
task_group_status run_and_wait(
   task_handle<_Function>& _Task_handle
);

template<
   class _Function
>
task_group_status run_and_wait(
   const _Function& _Func
);

Parameter

_Fungsi
Jenis objek fungsi yang akan dipanggil untuk menjalankan isi tugas.

_Task_handle
Handel ke tugas yang akan dijalankan sebaris pada konteks panggilan. Perhatikan bahwa penelepon memiliki tanggung jawab atas masa pakai objek ini. Runtime akan terus mengharapkannya hidup sampai metode selesai dieksekusi run_and_wait .

_Func
Fungsi yang akan dipanggil untuk memanggil isi pekerjaan. Ini mungkin ekspresi lambda atau objek lain yang mendukung versi operator panggilan fungsi dengan tanda tangan void operator()().

Tampilkan Nilai

Indikasi apakah penantian terpenuhi atau grup tugas dibatalkan, karena operasi pembatalan eksplisit atau pengecualian dilemparkan dari salah satu tugasnya. Untuk informasi selengkapnya, lihat task_group_status.

Keterangan

Perhatikan bahwa satu atau beberapa tugas yang dijadwalkan ke objek ini task_group dapat dijalankan sebaris pada konteks panggilan.

Jika satu atau beberapa tugas yang dijadwalkan ke objek ini task_group memunculkan pengecualian, runtime akan memilih satu pengecualian tersebut dari pemilihannya dan menyebarkannya keluar dari panggilan ke run_and_wait metode .

Setelah dikembalikan dari run_and_wait metode pada task_group objek, runtime mengatur ulang objek ke status bersih di mana dapat digunakan kembali. Ini termasuk kasus di task_group mana objek dibatalkan.

Dalam jalur eksekusi yang tidak luar biasa, Anda memiliki mandat untuk memanggil metode ini atau wait metode sebelum destruktor task_group eksekusi.

task_group

Membuat objek baru task_group .

task_group();

task_group(
   cancellation_token _CancellationToken
);

Parameter

_CancellationToken
Token pembatalan untuk dikaitkan dengan grup tugas ini. Grup tugas akan dibatalkan ketika token dibatalkan.

Keterangan

Konstruktor yang mengambil token pembatalan membuat task_group yang akan dibatalkan ketika sumber yang terkait dengan token dibatalkan. Menyediakan token pembatalan eksplisit juga mengisolasi grup tugas ini agar tidak berpartisipasi dalam pembatalan implisit dari grup induk dengan token yang berbeda atau tanpa token.

~task_group

Menghancurkan objek task_group . Anda diharapkan untuk memanggil wait metode atau run_and_wait pada objek sebelum destruktor yang dijalankan, kecuali destruktor dijalankan sebagai hasil dari pelepasan tumpukan karena pengecualian.

~task_group();

Keterangan

Jika destruktor berjalan sebagai hasil dari eksekusi normal (misalnya, tidak melepas tumpukan karena pengecualian) dan baik wait metode maupun run_and_wait yang telah dipanggil, destruktor dapat melemparkan pengecualian missing_wait .

tunggu

Menunggu hingga semua pekerjaan pada task_group objek selesai atau dibatalkan.

task_group_status wait();

Tampilkan Nilai

Indikasi apakah penantian terpenuhi atau grup tugas dibatalkan, karena operasi pembatalan eksplisit atau pengecualian dilemparkan dari salah satu tugasnya. Untuk informasi selengkapnya, lihat task_group_status.

Keterangan

Perhatikan bahwa satu atau beberapa tugas yang dijadwalkan ke objek ini task_group dapat dijalankan sebaris pada konteks panggilan.

Jika satu atau beberapa tugas yang dijadwalkan ke objek ini task_group memunculkan pengecualian, runtime akan memilih satu pengecualian tersebut dari pemilihannya dan menyebarkannya keluar dari panggilan ke wait metode .

Memanggil wait pada task_group objek mengatur ulang ke status bersih tempat objek dapat digunakan kembali. Ini termasuk kasus di task_group mana objek dibatalkan.

Dalam jalur eksekusi yang tidak luar biasa, Anda memiliki mandat untuk memanggil metode ini atau run_and_wait metode sebelum destruktor task_group eksekusi.

Lihat juga

Namespace layanan konkurensi
Kelas structured_task_group
Kelas task_handle