CKTIS / C++
std::this_thread::sleep_for — de huidige thread pauzeren
std::this_thread::sleep_for blokkeert de aanroepende thread gedurende een relatief interval dat wordt uitgedrukt als std::chrono::duration. De functie maakt geen thread aan en synchroniseert geen gegevenstoegang. Terugkeren kan langer duren dan het gevraagde interval.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <thread>
#include <chrono>
template<class Rep, class Period>
void std::this_thread::sleep_for(
const std::chrono::duration<Rep, Period>& rel_time);std::this_thread::sleep_for, gedeclareerd in <thread>, blokkeert de thread die de functie aanroept. Het argument rel_time is een tijdsduur van het type std::chrono::duration<Rep, Period>; neem <chrono> op om tijdseenheden uit te drukken. De functie retourneert void. Een aanroep in main pauzeert dus de thread die main uitvoert, in plaats van een achtergrondtaak aan te maken.
Dit is een relatieve wachttijd: std::chrono::milliseconds{20} geeft een interval aan, geen tijdstip waarop de functie klaar is. Verwacht bij een positieve duur geen terugkeer precies na dat interval: threadplanning en concurrentie om bronnen kunnen het wachten verlengen. De standaard beveelt implementaties aan de tijd met een monotone klok te meten, maar verplicht het gebruik van std::chrono::steady_clock niet. std::this_thread::sleep_until accepteert daarentegen een tijdstip.
De functie biedt geen synchronisatie: alleen wachten bewijst niet dat een andere thread klaar is en maakt gedeelde gegevens niet veilig. Gebruik voor coördinatie een geschikt synchronisatiemechanisme, in plaats van aan te nemen dat een gekozen pauze volstaat. De specificatie staat uitzonderingen toe die met tijdmeting verband houden; de standaardklok- en tijdtypen die de implementatie levert, gooien deze niet.
Het voorbeeld voert één pauze uit tussen twee uitvoerbewerkingen. De verwachte uitvoer heeft een vaste volgorde, maar de exacte uitvoeringstijd maakt geen deel uit van het resultaat. De bron is een veranderend werkdocument, geen vastgelegde C++23-editie.
Voorbeelden
#include <chrono>
#include <iostream>
#include <thread>
int main() {
std::cout << "Before\n";
std::this_thread::sleep_for(std::chrono::milliseconds{20});
std::cout << "After\n";
}
Resultaat
Before After
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.