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

CKTIS / C++

std::chrono::duration_cast — conversão explícita de duração

std::chrono::duration_cast converte uma duração para o tipo std::chrono::duration indicado. Se o ajuste de escala exigir uma divisão inteira, o quociente é truncado em direção a zero depois de o número de unidades ser convertido para um tipo intermédio comum. A função não verifica se ocorre overflow.

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

Sintaxe

std::chrono::duration_cast<ToDuration>(d)

A função std::chrono::duration_cast, declarada em <chrono>, devolve uma nova duração sem alterar d. ToDuration tem de ser uma especialização de std::chrono::duration, como std::chrono::seconds, e não int. O resultado é um objeto de duração; utiliza .count() para obter o número de unidades.

Se os períodos de origem e de destino forem iguais, a função converte o número de unidades de origem diretamente para o tipo de representação de destino. Não passar pelo tipo intermédio comum pode alterar as conversões invocadas quando um tipo de representação é um tipo de classe. Se os períodos forem diferentes, a função começa por converter o número de unidades de origem para um tipo intermédio comum, ajusta-o de acordo com a razão entre o período de origem e o de destino e, por fim, converte o resultado para o tipo de representação de destino. A divisão inteira trunca o quociente em direção a zero, mas é efetuada sobre o valor já convertido. Se tanto o tipo intermédio como o tipo de representação de destino forem unsigned long long, ao converter -500 milissegundos em segundos, -500 passa a ser um valor elevado sem sinal antes da divisão por 1000. O resultado é, portanto, um número elevado e positivo de segundos, e não zero. No exemplo apresentado, -1750 milissegundos passam a -1 segundo, e não a -2. Converter o resultado novamente em milissegundos não permite recuperar os 750 milissegundos perdidos.

O construtor duration permite algumas conversões implícitas, mas bloqueia, entre outras, a conversão de milissegundos inteiros para segundos inteiros. duration_cast permite pedir essa conversão explicitamente. No entanto, não verifica o intervalo: uma multiplicação intermédia pode causar overflow, e o overflow de um inteiro com sinal provoca comportamento indefinido. Na conversão de vírgula flutuante para inteiro, evita NaN, infinito e valores cujo resultado truncado não seja representável no tipo de destino; nesses casos, o comportamento é indefinido.

Exemplos

#include <chrono>
#include <iostream>

int main() {
    constexpr std::chrono::milliseconds input{-1750};
    constexpr auto whole =
        std::chrono::duration_cast<std::chrono::seconds>(input);
    constexpr auto restored =
        std::chrono::duration_cast<std::chrono::milliseconds>(whole);

    static_assert(whole.count() == -1);
    static_assert(restored.count() == -1000);

    std::cout << whole.count() << '\n'
              << restored.count() << '\n';
}

Resultado

-1
-1000

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