CKTIS / C++
std::chrono::duration_cast — conversión explícita de duración
std::chrono::duration_cast convierte una duración al tipo std::chrono::duration indicado. Si el escalado requiere una división entera, el cociente se trunca hacia cero después de convertir el número de unidades a un tipo intermedio común. La función no comprueba si hay desbordamientos.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
std::chrono::duration_cast<ToDuration>(d)La función std::chrono::duration_cast, declarada en <chrono>, devuelve una nueva duración sin modificar d. ToDuration debe ser una especialización de std::chrono::duration, como std::chrono::seconds, y no int. El resultado es un objeto de duración; usa .count() para obtener el número de unidades.
Si los periodos de origen y destino son iguales, la función convierte el número de unidades de origen directamente al tipo de representación de destino. Omitir el tipo intermedio común puede cambiar qué conversiones se invocan cuando un tipo de representación es un tipo de clase. Si los periodos son distintos, la función convierte primero el número de unidades de origen a un tipo intermedio común, lo escala según la razón entre el periodo de origen y el de destino y, después, convierte el resultado al tipo de representación de destino. La división entera trunca el cociente hacia cero, pero se aplica al valor ya convertido. Si tanto el tipo intermedio como el de representación de destino son unsigned long long, al convertir -500 milisegundos a segundos, -500 se convierte en un valor grande sin signo antes de dividirlo entre 1000. El resultado es, por tanto, un número positivo grande de segundos, no cero. En el ejemplo mostrado, -1750 milisegundos se convierten en -1 segundo, no en -2. Convertir de nuevo a milisegundos no permite recuperar los 750 milisegundos perdidos.
El constructor duration permite algunas conversiones implícitas, pero bloquea, entre otras, la conversión de milisegundos enteros a segundos enteros. duration_cast permite solicitar explícitamente esa conversión. Sin embargo, no comprueba el rango: una multiplicación intermedia puede desbordarse, y el desbordamiento de un entero con signo causa comportamiento indefinido. Al convertir de coma flotante a entero, evita NaN, el infinito y los valores cuyo resultado truncado no se pueda representar en el tipo de destino; en esos casos, el comportamiento es indefinido.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.