CKTIS / C++
std::this_thread::sleep_for — wstrzymanie bieżącego wątku
std::this_thread::sleep_for wstrzymuje wywołujący wątek na względny czas podany jako std::chrono::duration. Nie tworzy wątku i nie synchronizuje dostępu do danych. Powrót może nastąpić później niż po zadanym czasie.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 z nagłówka <thread> blokuje wątek, który ją wywołał. Argument rel_time jest czasem trwania typu std::chrono::duration<Rep, Period>; do zapisu jednostek czasu dołącz <chrono>. Funkcja zwraca void. Wywołanie w main wstrzymuje więc wątek wykonujący main, a nie tworzy zadania działającego w tle.
Jest to oczekiwanie względne: std::chrono::milliseconds{20} oznacza czas trwania, nie godzinę zakończenia. Dla dodatniego czasu nie zakładaj powrotu dokładnie po jego upływie: planowanie wątków i obciążenie zasobów mogą wydłużyć oczekiwanie. Standard zaleca implementacjom pomiar zegarem monotonicznym, ale nie nakazuje użycia std::chrono::steady_clock. std::this_thread::sleep_until przyjmuje natomiast punkt czasu.
Funkcja nie zapewnia synchronizacji: samo odczekanie nie dowodzi, że inny wątek zakończył pracę, ani nie czyni współdzielonych danych bezpiecznymi. Do koordynacji użyj odpowiedniego mechanizmu synchronizacji, zamiast zakładać, że wybrana pauza wystarczy. Specyfikacja dopuszcza wyjątki związane z pomiarem czasu; standardowe typy zegarów i czasu dostarczane przez implementację ich nie zgłaszają.
Przykład wykonuje jedną pauzę między dwiema operacjami wypisywania. Oczekiwane wyjście ma stałą kolejność, lecz dokładny czas działania nie jest częścią wyniku. Źródłem jest aktualizowany szkic standardu, a nie zamrożone wydanie C++23.
Przykłady
#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";
}
Wynik
Before After
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.