CKTIS / C++
std::chrono::duration_cast — explicitní převod doby trvání
std::chrono::duration_cast převádí dobu trvání na zadaný typ std::chrono::duration. Pokud přepočet vyžaduje celočíselné dělení, podíl se ořízne směrem k nule po převodu počtu jednotek na společný mezilehlý typ. Funkce nekontroluje přetečení.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
std::chrono::duration_cast<ToDuration>(d)Funkce std::chrono::duration_cast deklarovaná v <chrono> vrací novou dobu trvání a nemění d. ToDuration musí být specializací std::chrono::duration, například std::chrono::seconds, nikoli typem int. Výsledkem je objekt doby trvání; počet jednotek získáte pomocí .count().
Pokud jsou zdrojová a cílová perioda stejné, funkce převede původní počet jednotek přímo na typ cílové reprezentace. Vynechání společného mezilehlého typu může ovlivnit, které konverze se vyvolají, pokud je typ reprezentace třídním typem. Pokud se periody liší, funkce nejprve převede původní počet jednotek na společný mezilehlý typ, přepočítá jej podle poměru zdrojové periody k cílové a poté výsledek převede na typ cílové reprezentace. Celočíselné dělení ořízne podíl směrem k nule, ale pracuje s již převedenou hodnotou. Pokud je mezilehlým typem i typem cílové reprezentace unsigned long long, při převodu -500 milisekund na sekundy se z -500 ještě před dělením číslem 1000 stane velká hodnota bez znaménka. Výsledkem je tedy velký kladný počet sekund, nikoli nula. V uvedeném příkladu se -1750 milisekund převede na -1 sekundu, nikoli na -2. Převod zpět na milisekundy nedokáže ztracených 750 milisekund obnovit.
Konstruktor duration povoluje některé implicitní převody, ale mimo jiné blokuje převod celočíselných milisekund na celočíselné sekundy. duration_cast umožňuje takový převod výslovně vyžádat. Nekontroluje však rozsah: při mezilehlém násobení může dojít k přetečení a přetečení celočíselného typu se znaménkem způsobuje nedefinované chování. Při převodu z čísla s plovoucí řádovou čárkou na celé číslo se vyhněte NaN, nekonečnu a hodnotám, jejichž oříznutý výsledek nelze vyjádřit cílovým typem; chování je pak nedefinované.
Příklady
#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';
}
Výsledek
-1 -1000
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.