CKTIS / C++
std::this_thread::sleep_for — den aktuellen Thread pausieren
std::this_thread::sleep_for blockiert den aufrufenden Thread für ein relatives Zeitintervall, das als std::chrono::duration angegeben wird. Die Funktion erstellt keinen Thread und synchronisiert keinen Datenzugriff. Die Rückkehr kann später als nach dem angeforderten Intervall erfolgen.
Version: 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, deklariert in <thread>, blockiert den Thread, der die Funktion aufruft. Das Argument rel_time ist eine Dauer vom Typ std::chrono::duration<Rep, Period>; um Zeiteinheiten anzugeben, muss <chrono> eingebunden werden. Die Funktion gibt void zurück. Ein Aufruf in main pausiert daher den Thread, der main ausführt, statt eine Hintergrundaufgabe zu erstellen.
Dies ist ein relatives Warten: std::chrono::milliseconds{20} gibt ein Intervall und keinen Zeitpunkt für den Abschluss an. Bei einer positiven Dauer sollte die Rückkehr nicht genau nach diesem Intervall erwartet werden: Thread-Scheduling und Ressourcenkonkurrenz können das Warten verlängern. Der Standard empfiehlt, dass Implementierungen die Zeit mit einer monotonen Uhr messen, schreibt die Verwendung von std::chrono::steady_clock jedoch nicht vor. std::this_thread::sleep_until nimmt dagegen einen Zeitpunkt entgegen.
Die Funktion bietet keine Synchronisierung: Allein das Warten beweist weder, dass ein anderer Thread seine Arbeit beendet hat, noch macht es gemeinsam genutzte Daten sicher. Verwende zur Koordination einen geeigneten Synchronisierungsmechanismus, statt anzunehmen, eine gewählte Pause reiche aus. Die Spezifikation erlaubt Ausnahmen im Zusammenhang mit der Zeitmessung; die von der Implementierung bereitgestellten Standardtypen für Uhren und Zeit lösen diese nicht aus.
Das Beispiel legt zwischen zwei Ausgabeoperationen eine Pause ein. Die erwartete Ausgabe hat eine feste Reihenfolge, aber die genaue Ausführungszeit ist nicht Teil des Ergebnisses. Die Quelle ist ein fortlaufend weiterentwickelter Arbeitsentwurf und keine eingefrorene C++23-Ausgabe.
Beispiele
#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";
}
Ergebnis
Before After
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.