CKTIS / C++
std::chrono::duration_cast — eksplicitna pretvorba trajanja
std::chrono::duration_cast pretvara trajanje u zadani tip std::chrono::duration. Ako skaliranje zahtijeva cjelobrojno dijeljenje, količnik se skraćuje prema nuli nakon što se broj jedinica pretvori u zajednički međutip. Funkcija ne provjerava prekoračenje.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
std::chrono::duration_cast<ToDuration>(d)Funkcija std::chrono::duration_cast, deklarirana u <chrono>, vraća novo trajanje bez promjene d. ToDuration mora biti specijalizacija tipa std::chrono::duration, primjerice std::chrono::seconds, a ne int. Rezultat je objekt trajanja; broj jedinica dohvatite pomoću .count().
Ako su izvorni i odredišni period jednaki, funkcija pretvara izvorni broj jedinica izravno u tip odredišnog prikaza. Preskakanje zajedničkog međutipa može utjecati na to koje se pretvorbe pozivaju kada je tip prikaza klasni tip. Ako se periodi razlikuju, funkcija najprije pretvara izvorni broj jedinica u zajednički međutip, skalira ga prema omjeru izvornog perioda i odredišnog perioda, a zatim pretvara rezultat u tip odredišnog prikaza. Cjelobrojno dijeljenje skraćuje količnik prema nuli, ali dijeli već pretvorenu vrijednost. Ako su i međutip i tip odredišnog prikaza unsigned long long, pri pretvorbi -500 milisekundi u sekunde vrijednost -500 postaje velika nepredznačena vrijednost još prije dijeljenja s 1000. Rezultat je stoga velik pozitivan broj sekundi, a ne nula. U prikazanom primjeru -1750 milisekundi postaje -1 sekunda, a ne -2. Pretvaranjem natrag u milisekunde nije moguće vratiti izgubljenih 750 milisekundi.
Konstruktor duration dopušta neke implicitne pretvorbe, ali među ostalim blokira pretvorbu cijelih milisekundi u cijele sekunde. duration_cast omogućuje da se takva pretvorba izričito zatraži. Ipak, ne provjerava raspon: međumnoženje može prekoračiti raspon, a prekoračenje kod predznačenog cjelobrojnog tipa uzrokuje nedefinirano ponašanje. Pri pretvorbi iz broja s pomičnim zarezom u cijeli broj izbjegavajte NaN, beskonačnost i vrijednosti čiji odrezani rezultat nije moguće prikazati odredišnim tipom; tada je ponašanje nedefinirano.
Primjeri
#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';
}
Rezultat
-1 -1000
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.