CKTIS / C++
std::chrono::duration_cast — explicitná konverzia trvania
std::chrono::duration_cast konvertuje trvanie na zadaný typ std::chrono::duration. Ak prepočet vyžaduje celočíselné delenie, podiel sa oreže smerom k nule po konverzii počtu jednotiek na spoločný medzityp. Funkcia nekontroluje pretečenie.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
std::chrono::duration_cast<ToDuration>(d)Funkcia std::chrono::duration_cast deklarovaná v <chrono> vráti nové trvanie bez zmeny d. ToDuration musí byť špecializáciou std::chrono::duration, napríklad std::chrono::seconds, nie typom int. Výsledkom je objekt trvania; počet jednotiek získate pomocou .count().
Ak sú zdrojová a cieľová perióda rovnaké, funkcia prevedie pôvodný počet jednotiek priamo na typ cieľovej reprezentácie. Vynechanie spoločného medzitypu môže ovplyvniť, ktoré konverzie sa vyvolajú, ak je typ reprezentácie typom triedy. Ak sa periódy líšia, funkcia najprv prevedie pôvodný počet jednotiek na spoločný medzityp, prepočíta ho podľa pomeru zdrojovej periódy k cieľovej a potom prevedie výsledok na typ cieľovej reprezentácie. Celočíselné delenie oreže podiel smerom k nule, ale pracuje už s prevedenou hodnotou. Ak je medzitypom aj typom cieľovej reprezentácie unsigned long long, pri prevode -500 milisekúnd na sekundy sa z -500 ešte pred delením číslom 1000 stane veľká hodnota bez znamienka. Výsledkom je teda veľký kladný počet sekúnd, nie nula. V uvedenom príklade sa -1750 milisekúnd zmení na -1 sekundu, nie na -2. Konverzia späť na milisekundy nedokáže obnoviť stratených 750 milisekúnd.
Konštruktor duration povoľuje niektoré implicitné konverzie, ale okrem iného blokuje konverziu celočíselných milisekúnd na celočíselné sekundy. duration_cast umožňuje takúto konverziu výslovne vyžiadať. Nekontroluje však rozsah: pri medzivýpočte môže násobenie viesť k pretečeniu a pretečenie celočíselného typu so znamienkom spôsobuje nedefinované správanie. Pri konverzii z čísla s pohyblivou rádovou čiarkou na celé číslo sa vyhnite NaN, nekonečnu a hodnotám, ktorých orezaný výsledok sa nedá vyjadriť cieľovým typom; správanie je potom nedefinované.
Prí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ýsledok
-1 -1000
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.