Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::this_thread::sleep_for — pozastavení aktuálního vlákna

std::this_thread::sleep_for zablokuje volající vlákno na relativní interval vyjádřený jako std::chrono::duration. Nevytváří vlákno ani nesynchronizuje přístup k datům. Návrat může nastat později než po požadovaném intervalu.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#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, deklarovaná v <thread>, zablokuje vlákno, které ji zavolá. Argument rel_time je doba typu std::chrono::duration<Rep, Period>; pro vyjádření časových jednotek vložte <chrono>. Funkce vrací void. Volání v main tedy pozastaví vlákno, které vykonává main, místo aby vytvořilo úlohu na pozadí.

Jde o relativní čekání: std::chrono::milliseconds{20} určuje interval, nikoli okamžik dokončení. U kladné doby nepočítejte s návratem přesně po uplynutí tohoto intervalu: plánování vláken a soupeření o prostředky mohou čekání prodloužit. Standard implementacím doporučuje měřit čas monotónními hodinami, ale nenařizuje použití std::chrono::steady_clock. Naproti tomu std::this_thread::sleep_until přijímá časový okamžik.

Funkce neposkytuje synchronizaci: samotné čekání nedokazuje, že jiné vlákno dokončilo práci, ani nezajišťuje bezpečnost sdílených dat. Ke koordinaci použijte vhodný synchronizační mechanismus a nepředpokládejte, že zvolená pauza stačí. Specifikace povoluje výjimky související s měřením času; standardní typy hodin a času dodávané implementací je nevyhazují.

Příklad provede jednu pauzu mezi dvěma výstupními operacemi. Očekávaný výstup má pevné pořadí, ale přesná doba běhu není součástí výsledku. Zdrojem je průběžně se vyvíjející pracovní návrh, nikoli zmrazené vydání C++23.

Příklady

#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";
}

Výsledek

Before
After

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje