WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::chrono::duration: Taktzahl mit festem Zeitraum

std::chrono::duration<Rep, Period> stellt ein Zeitintervall als Anzahl von Takten dar, deren Dauer ein konstanter Sekundenbruch ist.

Version: C++23

Syntax

template<class Rep, class Period = std::ratio<1>>
class duration {
public:
    constexpr Rep count() const;
};

using nanoseconds  = duration</* signed integer type */, std::nano>;
using milliseconds = duration</* signed integer type */, std::milli>;
using seconds      = duration</* signed integer type */>;
using minutes      = duration</* signed integer type */, std::ratio<60>>;
using days         = duration</* signed integer type */, std::ratio<86400>>;

std::chrono::duration<Rep, Period> aus <chrono> speichert einen Rep-Wert; Period ist ein positives std::ratio für die Länge eines Takts in Sekunden. Aliase wie seconds, milliseconds und nanoseconds unterscheiden sich in Zeitraum und oft Repräsentation. count() liefert die rohe Taktzahl, nicht Sekunden.

std::chrono::nanoseconds, std::chrono::milliseconds, std::chrono::seconds, std::chrono::minutes und std::chrono::days sind Standardaliase von duration mit Perioden von 10^-9 s, 10^-3 s, 1 s, 60 s beziehungsweise 86400 s. std::chrono::duration::count liefert den Repräsentationswert in der Periode dieses Objekts; die Zahl allein enthält keine Einheit.

Duration-Arithmetik wählt gemeinsame Repräsentation und Periode. Implizite Konvertierung ganzzahliger Repräsentationen ist nur ohne Verlust eines Bruchteils erlaubt. Bei ganzzahligem Ziel-Rep schneidet duration_cast gegen null ab; floor, ceil und round wählen andere Regeln. Bei Fließkomma-Ziel gelten dessen normale Regeln.

Genauigkeit und Bereich hängen von Rep ab. Überlauf und Division durch null folgen dessen Regeln; bei ganzzahligem Rep sind vorzeichenbehafteter Überlauf und Division durch null undefiniertes Verhalten. zero(), min() und max() liefern Spezialwerte. Ein Intervall ist kein time_point, der es an eine Uhr bindet.

Beispiele

#include <chrono>
#include <iostream>

int main() {
    const std::chrono::milliseconds elapsed{1500};
    const auto wholeSeconds = std::chrono::duration_cast<std::chrono::seconds>(elapsed);
    std::cout << elapsed.count() << ' ' << wholeSeconds.count() << '\n';
}

Ergebnis

1500 1

std::chrono::duration → 1500 1

Quellen