Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::chrono::duration_cast — izrecna pretvorba trajanja

std::chrono::duration_cast pretvori trajanje v navedeni tip std::chrono::duration. Če preračun zahteva celoštevilsko deljenje, se količnik odreže proti ničli po pretvorbi števila enot v skupni vmesni tip. Funkcija ne preverja prekoračitve.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

std::chrono::duration_cast<ToDuration>(d)

Funkcija std::chrono::duration_cast, deklarirana v <chrono>, vrne novo trajanje, ne da bi spremenila d. ToDuration mora biti specializacija tipa std::chrono::duration, na primer std::chrono::seconds, ne pa int. Rezultat je objekt trajanja; število enot pridobite z .count().

Če sta izvorna in ciljna perioda enaki, funkcija pretvori izvorno število enot neposredno v tip ciljne predstavitve. Izpustitev skupnega vmesnega tipa lahko vpliva na to, katere pretvorbe se prikličejo, kadar je tip predstavitve razredni tip. Če se periodi razlikujeta, funkcija najprej pretvori izvorno število enot v skupni vmesni tip, ga preračuna glede na razmerje med izvorno in ciljno periodo ter nato rezultat pretvori v tip ciljne predstavitve. Celoštevilsko deljenje odreže količnik proti ničli, vendar pri tem uporabi že pretvorjeno vrednost. Če sta vmesni tip in tip ciljne predstavitve oba unsigned long long, se pri pretvorbi -500 milisekund v sekunde vrednost -500 že pred deljenjem s 1000 pretvori v veliko nepredznačeno vrednost. Rezultat je zato veliko pozitivno število sekund, ne nič. V prikazanem primeru -1750 milisekund postane -1 sekunda, ne -2. S pretvorbo nazaj v milisekunde izgubljenih 750 milisekund ni mogoče obnoviti.

Konstruktor duration dovoljuje nekatere implicitne pretvorbe, vendar med drugim preprečuje pretvorbo celoštevilskih milisekund v celoštevilske sekunde. duration_cast omogoča, da takšno pretvorbo izrecno zahtevate. Vendar ne preverja obsega: vmesno množenje lahko povzroči prekoračitev, prekoračitev pri predznačenem celoštevilskem tipu pa povzroči nedefinirano vedenje. Pri pretvorbi iz števila s plavajočo vejico v celo število se izogibajte NaN, neskončnosti in vrednostim, katerih odrezani rezultat ni predstavljiv v ciljnem tipu; sicer je vedenje nedefinirano.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri