CKTIS / C++
std::latch — attendre une seule fois qu’un compteur atteigne zéro
std::latch de <latch> permet aux threads d’attendre qu’un compteur atteigne zéro. count_down() signale l’achèvement d’une unité de travail, tandis que wait() attend la fin du décompte sans modifier le compteur.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <latch>
std::latch done{expected};
done.count_down();
done.wait();std::latch est un mécanisme de synchronisation à usage unique fourni par <latch>. Son constructeur initialise le compteur à expected, qui doit satisfaire 0 <= expected && expected <= std::latch::max(). Le compteur représente les signalements encore attendus, qui ne proviennent pas nécessairement de threads distincts. Une fois le compteur à zéro, l’objet ne peut être ni réinitialisé ni réutilisé pour un autre tour.
std::latch::count_down(update) soustrait atomiquement update, dont la valeur par défaut est 1. Il faut que 0 <= update, et update ne doit pas dépasser la valeur actuelle du compteur ; n’appelez donc pas count_down() avec sa valeur par défaut lorsque le compteur est déjà à zéro. Cette méthode n’attend pas les autres signalements. std::latch::wait() ne décrémente pas le compteur : l’appel se bloque jusqu’à ce que le compteur atteigne zéro, ou retourne immédiatement s’il est déjà à zéro. Si des signalements manquent, l’attente peut durer indéfiniment.
En C++23, count_down() précède, au sens de la relation strongly happens-before, le retour des appels débloqués sur ce latch. Cette garantie ne couvre pas explicitement un appel à wait() qui commence après que le compteur a atteint zéro. Dans l’exemple, worker peut appeler count_down() avant que le thread principal n’appelle wait(). wait() ne suffit donc pas à garantir que la lecture non atomique de result est sûre quel que soit l’ordonnancement des threads. Le latch ne protège pas non plus contre des écritures concurrentes arbitraires dans des données partagées.
L’objet doit rester en vie pendant les opérations qui le concernent. Dans l’exemple, worker est détruit avant done, mais le thread principal ne s’en remet pas au destructeur de std::jthread : il appelle explicitement worker.join() après wait() et avant de lire result. La fin du thread de travail se synchronise avec le retour réussi de worker.join(). La lecture de result est donc sûre, que wait() ait bloqué ou non. Si l’exécution réussit, le programme affiche 42 suivi d’un saut de ligne.
Exemples
#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';
}
Résultat
42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.