WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::chrono::duration_cast — explizite Dauerumwandlung

std::chrono::duration_cast wandelt eine Dauer in einen angegebenen std::chrono::duration-Typ um. Ist zur Skalierung eine Ganzzahldivision nötig, wird der Quotient nach der Umwandlung der Einheitenzahl in einen gemeinsamen Zwischentyp in Richtung null abgeschnitten. Die Funktion prüft nicht auf Überlauf.

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

Syntax

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

Die Funktion std::chrono::duration_cast aus <chrono> gibt eine neue Dauer zurück, ohne d zu verändern. ToDuration muss eine Spezialisierung von std::chrono::duration sein, zum Beispiel std::chrono::seconds, und darf nicht int sein. Das Ergebnis ist ein Dauerobjekt; seine Einheitenzahl erhält man mit .count().

Sind Quell- und Zielperiode gleich, wandelt die Funktion die ursprüngliche Einheitenzahl direkt in den Zielrepräsentationstyp um. Das Überspringen des gemeinsamen Zwischentyps kann beeinflussen, welche Konvertierungen aufgerufen werden, wenn ein Repräsentationstyp ein Klassentyp ist. Unterscheiden sich die Perioden, wandelt die Funktion die ursprüngliche Einheitenzahl zunächst in einen gemeinsamen Zwischentyp um, skaliert sie mit dem Verhältnis der Quellperiode zur Zielperiode und wandelt das Ergebnis anschließend in die Zielrepräsentation um. Die Ganzzahldivision schneidet den Quotienten in Richtung null ab, arbeitet aber mit der bereits umgewandelten Zahl. Sind sowohl der Zwischentyp als auch die Zielrepräsentation unsigned long long, wird beim Umrechnen von -500 Millisekunden in Sekunden aus -500 schon vor der Division durch 1000 ein großer vorzeichenloser Wert. Das Ergebnis ist daher eine große positive Sekundenzahl und nicht null. Im gezeigten Beispiel ergeben -1750 Millisekunden -1 Sekunde, nicht -2. Eine Rückumwandlung in Millisekunden kann die verlorenen 750 Millisekunden nicht wiederherstellen.

Der duration-Konstruktor erlaubt einige implizite Umwandlungen, verhindert aber unter anderem die Umwandlung von ganzzahligen Millisekunden in ganzzahlige Sekunden. duration_cast fordert eine solche Umwandlung ausdrücklich an. Die Funktion prüft jedoch nicht den Wertebereich: Eine Zwischenmultiplikation kann überlaufen, und ein Überlauf bei vorzeichenbehafteten Ganzzahlen führt zu undefiniertem Verhalten. Vermeide bei der Umwandlung von Fließkomma- in Ganzzahlwerte NaN, Unendlich und Werte, deren abgeschnittenes Ergebnis nicht im Zieltyp darstellbar ist – andernfalls ist das Verhalten undefiniert.

Beispiele

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

Ergebnis

-1
-1000

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen