Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori