Como usar cancelamento para parar um loop paralelo
Este exemplo mostra como usar o cancelar para implementar um algoritmo de pesquisa paralela básico.
Exemplo
O exemplo a seguir usa em cancelar para pesquisar por um elemento em uma matriz. A função de parallel_find_any usa o algoritmo de concurrency::parallel_for e a função de concurrency::run_with_cancellation_token para pesquisar pela posição que contém o valor fornecido. Quando o loop paralelo localiza o valor, ele chama o método de concurrency::cancellation_token_source::cancel para cancelar o trabalho futuro.
// parallel-array-search.cpp
// compile with: /EHsc
#include <ppl.h>
#include <iostream>
#include <random>
using namespace concurrency;
using namespace std;
// Returns the position in the provided array that contains the given value,
// or -1 if the value is not in the array.
template<typename T>
int parallel_find_any(const T a[], size_t count, const T& what)
{
// The position of the element in the array.
// The default value, -1, indicates that the element is not in the array.
int position = -1;
// Call parallel_for in the context of a cancellation token to search for the element.
cancellation_token_source cts;
run_with_cancellation_token([count, what, &a, &position, &cts]()
{
parallel_for(std::size_t(0), count, [what, &a, &position, &cts](int n) {
if (a[n] == what)
{
// Set the return value and cancel the remaining tasks.
position = n;
cts.cancel();
}
});
}, cts.get_token());
return position;
}
int wmain()
{
const size_t count = 10000;
int values[count];
// Fill the array with random values.
mt19937 gen(34);
for (size_t i = 0; i < count; ++i)
{
values[i] = gen()%10000;
}
// Search for any position in the array that contains value 3123.
const int what = 3123;
int position = parallel_find_any(values, count, what);
if (position >= 0)
{
wcout << what << L" is at position " << position << L'.' << endl;
}
else
{
wcout << what << L" is not in the array." << endl;
}
}
/* Sample output:
3123 is at position 7835.
*/
O algoritmo de concurrency::parallel_for atua simultaneamente. Consequentemente, não executa operações em uma ordem índice. Se a matriz contém várias instâncias do valor, o resultado pode ser de qualquer uma de suas posições.
Compilando o código
Copie o código de exemplo e cole-o em um projeto do Visual Studio, ou cole-o em um arquivo chamado parallel-array-search.cpp e execute o comando a seguir em uma janela de prompt de comando do Visual Studio.
cl.exe /EHsc parallel-array-search.cpp
Consulte também
Referência
Classe cancellation_token_source