CKTIS / C++
std::chrono::duration : nombre de tops avec une période
std::chrono::duration<Rep, Period> représente un intervalle comme un nombre de tops dont la période est une fraction constante de seconde.
Version : C++23
Syntaxe
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> de <chrono> stocke une valeur Rep, et Period est un std::ratio positif donnant un top en secondes. Les alias seconds, milliseconds et nanoseconds diffèrent par période et souvent représentation. count() renvoie le nombre brut de tops, pas des secondes.
std::chrono::nanoseconds, std::chrono::milliseconds, std::chrono::seconds, std::chrono::minutes et std::chrono::days sont des alias standard de duration, de périodes respectives 10^-9 s, 10^-3 s, 1 s, 60 s et 86400 s. std::chrono::duration::count renvoie la valeur de représentation dans la période de l’objet ; le nombre seul ne porte pas l’unité.
L’arithmétique choisit une représentation et une période communes. Une conversion implicite entre entiers n’est permise que sans perte fractionnaire. Si le Rep cible est entier, duration_cast tronque vers zéro ; floor, ceil et round choisissent d’autres règles. Avec un Rep flottant, les règles normales de cette représentation s’appliquent.
Précision et plage dépendent de Rep. Débordement et division par zéro suivent ses règles ; pour un Rep entier, débordement signé et division par zéro sont indéfinis. zero(), min() et max() donnent des valeurs spéciales. Un intervalle n’est pas un time_point ancré à une horloge.
Exemples
#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';
}
Résultat
1500 1
std::chrono::duration → 1500 1