Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::chrono::duration: conteggio di tick con un periodo

std::chrono::duration<Rep, Period> rappresenta un intervallo come conteggio di tick il cui periodo è una frazione costante di secondo.

Versione: C++23

Sintassi

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> di <chrono> memorizza un valore Rep, mentre Period è uno std::ratio positivo che definisce un tick in secondi. Alias come seconds, milliseconds e nanoseconds differiscono per periodo e spesso rappresentazione. count() restituisce i tick grezzi, non secondi.

std::chrono::nanoseconds, std::chrono::milliseconds, std::chrono::seconds, std::chrono::minutes e std::chrono::days sono alias standard di duration con periodi rispettivamente di 10^-9 s, 10^-3 s, 1 s, 60 s e 86400 s. std::chrono::duration::count restituisce il valore della rappresentazione nel periodo dell’oggetto; il numero da solo non contiene l’unità.

L’aritmetica sceglie rappresentazione e periodo comuni. La conversione implicita fra interi è permessa solo senza perdita frazionaria. Se il Rep di destinazione è intero, duration_cast tronca verso zero; floor, ceil e round scelgono altre regole. Con Rep floating-point valgono le normali regole della rappresentazione.

Precisione e intervallo dipendono da Rep. Overflow e divisione per zero seguono le sue regole; con Rep intero, overflow con segno e divisione per zero sono comportamento indefinito. zero(), min() e max() danno valori speciali. Un intervallo non è un time_point ancorato a un clock.

Esempi

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

Risultato

1500 1

std::chrono::duration → 1500 1

Fonti