KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::chrono::duration_cast — expliciete duurconversie

std::chrono::duration_cast zet een duur om naar een opgegeven std::chrono::duration-type. Als de herschaling een gehele deling vereist, wordt het quotiënt naar nul afgekapt nadat het aantal eenheden is omgezet naar een gemeenschappelijk tussentype. De functie controleert niet op overflow.

Versie: C++23; repository compiler flag, production runtime not attested

Syntax

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

De functie std::chrono::duration_cast uit <chrono> geeft een nieuwe duur terug zonder d te wijzigen. ToDuration moet een specialisatie van std::chrono::duration zijn, zoals std::chrono::seconds, en geen int. Het resultaat is een duurobject; gebruik .count() om het aantal eenheden op te vragen.

Als de bron- en doelperiode gelijk zijn, zet de functie het oorspronkelijke aantal eenheden rechtstreeks om naar het representatietype van het doel. Het overslaan van het gemeenschappelijke tussentype kan invloed hebben op welke conversies worden aangeroepen als een representatietype een klassetype is. Als de perioden verschillen, zet de functie het oorspronkelijke aantal eenheden eerst om naar een gemeenschappelijk tussentype, herschaalt het volgens de verhouding van de bronperiode tot de doelperiode en zet het resultaat vervolgens om naar het representatietype van het doel. Een gehele deling kapt het quotiënt af naar nul, maar gebruikt daarbij het al omgezette aantal. Als zowel het tussentype als het representatietype van het doel unsigned long long zijn, wordt bij het omzetten van -500 milliseconden naar seconden de waarde -500 al vóór de deling door 1000 een grote waarde zonder teken. Het resultaat is dus een groot positief aantal seconden, niet nul. In het getoonde voorbeeld wordt -1750 milliseconden omgezet naar -1 seconde, niet naar -2. Bij terugconversie naar milliseconden krijg je de verloren 750 milliseconden niet terug.

De duration-constructor staat sommige impliciete conversies toe, maar blokkeert onder andere de omzetting van gehele milliseconden naar gehele seconden. Met duration_cast kun je zo’n conversie expliciet aanvragen. Dit is echter geen bereikcontrole: bij een tussenliggende vermenigvuldiging kan overflow optreden, en overflow bij een geheelgetaltype met teken leidt tot ongedefinieerd gedrag. Vermijd bij conversie van een drijvendekommagetal naar een geheel getal NaN, oneindigheid en waarden waarvan het afgekapt resultaat niet in het doeltype past; in die gevallen is het gedrag ongedefinieerd.

Voorbeelden

#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';
}

Resultaat

-1
-1000

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen