CKTIS / C++
Konstanty zásad vykonávání algoritmů
Objekty std::execution::seq, std::execution::par, std::execution::par_unseq a std::execution::unseq určují, jakým způsobem se algoritmus smí vykonávat. Nezaručují zrychlení; volba zásady také mění požadavky na funkce, které zpracovávají prvky.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <algorithm>
#include <execution>
std::execution::seq
std::execution::par
std::execution::par_unseq
std::execution::unseq
std::transform(policy, first, last, output, operation);Hlavička <execution> poskytuje čtyři objekty inline constexpr, nikoli funkce nebo hodnoty výčtového typu. Jeden z nich předejte jako první argument přetížení algoritmu, které podporuje zásady vykonávání, například std::transform. Jejich typy jsou v pořadí sequenced_policy, parallel_policy, parallel_unsequenced_policy a unsequenced_policy v std::execution.
std::execution::seq vyžaduje sekvenční vykonávání ve volajícím vlákně. std::execution::par povoluje více vláken, ale volání funkce zpracovávající prvky se v rámci jednoho vlákna nepřekrývají. std::execution::par_unseq povoluje více vláken i neuspořádaná volání v každém z nich, což umožňuje vektorizaci. std::execution::unseq povoluje neuspořádaná volání ve volajícím vlákně, ale nepovoluje další vlákna. Zásady udělují oprávnění, nezaručují však paralelismus, vektorizaci ani zrychlení; sekvenční vykonávání je povoleno.
Nespoléhejte na pořadí zpracování prvků ani na to, že se současně vykonává jiná iterace. Zabraňte datovým závodům. U unseq a par_unseq způsobí volání funkce standardní knihovny, která není bezpečná pro vektorizaci, nedefinované chování; ve funkci zpracovávající prvky nezamykejte mutexy. U všech čtyř zásad vyvolá výjimka, která z této funkce unikne, std::terminate, a to i při použití seq. Pokud se nepodaří získat dočasnou paměť potřebnou k paralelizaci, může být vyhozena výjimka std::bad_alloc.
Příklad nezávisle počítá druhé mocniny a výsledky vypíše až po dokončení každého algoritmu. Všechny zásady poskytují stejný očekávaný výsledek; nejde o měření výkonu. Tento záznam se týká C++23; příznak kompilátoru v repozitáři nedokládá podporu v produkčním běhovém prostředí.
Příklady
#include <algorithm>
#include <array>
#include <cstddef>
#include <execution>
#include <iostream>
int main() {
const std::array<int, 4> input{1, 2, 3, 4};
const auto run = [&](auto policy) {
std::array<int, 4> output{};
std::transform(policy, input.begin(), input.end(), output.begin(),
[](int value) noexcept { return value * value; });
for (std::size_t i = 0; i < output.size(); ++i) {
if (i != 0) std::cout << ' ';
std::cout << output[i];
}
std::cout << '\n';
};
run(std::execution::seq);
run(std::execution::par);
run(std::execution::par_unseq);
run(std::execution::unseq);
}
Výsledek
1 4 9 16 1 4 9 16 1 4 9 16 1 4 9 16
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.