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

CKTIS / C++

std::chrono::duration: contagem de ticks com um período

std::chrono::duration<Rep, Period> representa um intervalo como contagem de ticks cujo período é uma fração constante de segundo.

Versão: C++23

Sintaxe

template<class Rep, class Period = std::ratio<1>>
class duration {
public:
    constexpr Rep count() const;
};

using nanoseconds  = duration</* signed integer type */, std::nano>;
using milliseconds = duration</* signed integer type */, std::milli>;
using seconds      = duration</* signed integer type */>;
using minutes      = duration</* signed integer type */, std::ratio<60>>;
using days         = duration</* signed integer type */, std::ratio<86400>>;

std::chrono::duration<Rep, Period>, de <chrono>, guarda um valor Rep, enquanto Period é um std::ratio positivo que define um tick em segundos. Alias como seconds, milliseconds e nanoseconds diferem no período e muitas vezes na representação. count() devolve ticks brutos, não segundos.

std::chrono::nanoseconds, std::chrono::milliseconds, std::chrono::seconds, std::chrono::minutes e std::chrono::days são alias standard de duration com períodos de 10^-9 s, 10^-3 s, 1 s, 60 s e 86400 s, respetivamente. std::chrono::duration::count devolve o valor da representação no período do objeto; o número isolado não transporta a unidade.

A aritmética escolhe representação e período comuns. Conversão implícita entre inteiros só é permitida sem perda fracionária. Se o Rep de destino for inteiro, duration_cast trunca para zero; floor, ceil e round escolhem outras regras. Com Rep de destino em ponto flutuante aplicam-se as regras normais dessa representação.

Precisão e intervalo dependem de Rep. Overflow e divisão por zero seguem as suas regras; com Rep inteiro, overflow com sinal e divisão por zero são comportamento indefinido. zero(), min() e max() dão valores especiais. Um intervalo não é um time_point ancorado num relógio.

Exemplos

#include <chrono>
#include <iostream>

int main() {
    const std::chrono::milliseconds elapsed{1500};
    const auto wholeSeconds = std::chrono::duration_cast<std::chrono::seconds>(elapsed);
    std::cout << elapsed.count() << ' ' << wholeSeconds.count() << '\n';
}

Resultado

1500 1

std::chrono::duration → 1500 1

Fontes