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.