CKTIS / C++
std::latch — esperar uma única vez que um contador chegue a zero
std::latch de <latch> permite que as threads aguardem até que um contador chegue a zero. count_down() assinala a conclusão de uma unidade de trabalho, enquanto wait() aguarda pelo fim da contagem decrescente sem alterar o contador.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <latch>
std::latch done{expected};
done.count_down();
done.wait();std::latch é um mecanismo de sincronização de utilização única disponibilizado por <latch>. O seu construtor define o contador como expected, que tem de satisfazer 0 <= expected && expected <= std::latch::max(). O contador representa os sinais ainda em falta, que não têm de vir de threads distintas. Depois de o contador chegar a zero, o objeto não pode ser reiniciado nem reutilizado noutra ronda.
std::latch::count_down(update) subtrai update atomicamente; o valor predefinido é 1. É necessário que 0 <= update, e update não pode exceder o valor atual do contador; por isso, não chame count_down() com o valor predefinido depois de o contador chegar a zero. Este método não aguarda pelos restantes sinais. std::latch::wait() não decrementa o contador: a chamada fica bloqueada até o contador chegar a zero ou retorna imediatamente se já estiver a zero. Se faltarem sinais, a espera pode prolongar-se indefinidamente.
Em C++23, count_down() precede, no sentido da relação strongly happens-before, o retorno das chamadas desbloqueadas no latch. Esta garantia não abrange explicitamente uma chamada a wait() que se inicia depois de o contador chegar a zero. No exemplo, worker pode chamar count_down() antes de a thread principal chamar wait(). Por si só, wait() não garante, portanto, que a leitura não atómica de result seja segura independentemente do escalonamento das threads. O latch também não protege contra escritas concorrentes arbitrárias em dados partilhados.
O objeto tem de permanecer vivo durante as operações sobre ele. No exemplo, worker é destruído antes de done, mas a thread principal não depende do destrutor de std::jthread: chama explicitamente worker.join() depois de wait() e antes de ler result. A conclusão da thread de trabalho sincroniza-se com o retorno bem-sucedido de worker.join(), pelo que a leitura de result é segura quer wait() tenha bloqueado quer não. Se a execução for bem-sucedida, o programa apresenta 42 seguido de uma mudança de linha.
Exemplos
#include <iostream>
#include <latch>
#include <thread>
int main() {
int result = 0;
std::latch done{1};
std::jthread worker([&] {
result = 42;
done.count_down();
});
done.wait();
worker.join();
std::cout << result << '\n';
}
Resultado
42
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.