Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::this_thread::sleep_for — pausar a thread atual

std::this_thread::sleep_for bloqueia a thread que a invoca durante um intervalo relativo expresso como std::chrono::duration. Não cria uma thread nem sincroniza o acesso aos dados. O retorno pode ocorrer depois do intervalo pedido.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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, declarada em <thread>, bloqueia a thread que a invoca. O argumento rel_time é uma duração do tipo std::chrono::duration<Rep, Period>; inclui <chrono> para expressar unidades de tempo. A função devolve void. Assim, uma chamada em main pausa a thread que executa main, em vez de criar uma tarefa em segundo plano.

É uma espera relativa: std::chrono::milliseconds{20} especifica um intervalo, não um instante de conclusão. Para uma duração positiva, não contes com um retorno exatamente após esse intervalo: o escalonamento das threads e a concorrência por recursos podem prolongar a espera. A norma recomenda que as implementações meçam o tempo com um relógio monotónico, mas não exige a utilização de std::chrono::steady_clock. Em contrapartida, std::this_thread::sleep_until aceita um instante.

A função não fornece sincronização: esperar, por si só, não prova que outra thread terminou nem torna seguros os dados partilhados. Para coordenar, usa um mecanismo de sincronização adequado, em vez de presumires que uma pausa escolhida é suficiente. A especificação permite exceções relacionadas com a medição do tempo; os tipos padrão de relógio e tempo fornecidos pela implementação não as lançam.

O exemplo efetua uma pausa entre duas operações de saída. A saída esperada tem uma ordem fixa, mas o tempo exato de execução não faz parte do resultado. A fonte é um projeto de norma em evolução, não uma edição C++23 congelada.

Exemplos

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

Resultado

Before
After

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes