QElapsedTimer Class

Documentation sur les fonctions membres

[constexpr noexcept default] QElapsedTimer::QElapsedTimer()

Crée un objet `QElapsedTimer` non valide. Un minuteur devient valide une fois qu'il a été lancé.

Voir également isValid() et start().

[static noexcept] QElapsedTimer::ClockType QElapsedTimer::clockType()

Renvoie le type d'horloge utilisé par cette implémentation de ` QElapsedTimer `.

Depuis Qt 6.6, ` QElapsedTimer ` utilise ` std::chrono::steady_clock`, de sorte que le type d'horloge est toujours ` MonotonicClock`.

Voir également ` isMonotonic()`.

[noexcept, since 6.6] QElapsedTimer::Duration QElapsedTimer::durationElapsed() const

Renvoie une instance de ` std::chrono::nanoseconds ` contenant le temps écoulé depuis le dernier démarrage de cette instance de ` QElapsedTimer `.

L'appel de cette fonction sur une instance de ` QElapsedTimer ` non valide entraîne un comportement indéfini.

Sur les plateformes ne prenant pas en charge la résolution en nanosecondes, la valeur renvoyée correspondra à la meilleure estimation disponible.

Cette fonction a été introduite dans Qt 6.6.

Voir également start(), restart(), hasExpired() et invalidate().

[noexcept, since 6.6] QElapsedTimer::Duration QElapsedTimer::durationTo(const QElapsedTimer &other) const

Renvoie la différence de temps entre cet objet ` QElapsedTimer ` et ` other ` sous la forme d’un ` std::chrono::nanoseconds`. Si ` other ` a été lancé avant cet objet, la valeur renvoyée sera négative. S’il a été lancé après, la valeur renvoyée sera positive.

La valeur de retour est indéfinie si cet objet ou other ont été invalidés.

Cette fonction a été introduite dans Qt 6.6.

Voir également secsTo() et elapsed().

[noexcept] qint64 QElapsedTimer::elapsed() const

Renvoie le nombre de millisecondes écoulées depuis le dernier démarrage de cette instance de ` QElapsedTimer `.

L'appel de cette fonction sur une instance ` QElapsedTimer ` non valide entraîne un comportement indéfini.

Voir également start(), restart(), hasExpired(), isValid() et invalidate().

[noexcept] bool QElapsedTimer::hasExpired(qint64 timeout) const

Renvoie ` true ` si ` elapsed()` dépasse la valeur ` timeout` indiquée, sinon ` false`.

Une valeur négative de ` timeout ` est interprétée comme infinie ; dans ce cas, la fonction ` false ` est renvoyée. Sinon, cela revient à ` elapsed() > timeout`. Vous pouvez procéder de la même manière pour une durée en comparant ` durationElapsed()` à un délai d’expiration de durée.

Voir également elapsed() et QDeadlineTimer.

[noexcept] void QElapsedTimer::invalidate()

Marque cet objet ` QElapsedTimer ` comme non valide.

La validité d’un objet peut être vérifiée à l’aide de la fonction ` isValid()`. Les calculs du temps écoulé depuis la réception de données non valides ne sont pas définis et sont susceptibles de produire des résultats aberrants.

Voir également isValid(), start() et restart().

[static noexcept] bool QElapsedTimer::isMonotonic()

Renvoie « true » s'il s'agit d'une horloge monotone, « false » dans le cas contraire. Consultez les informations sur les différents types d'horloges pour savoir lesquels sont monotones.

Depuis Qt 6.6, ` QElapsedTimer ` utilise ` std::chrono::steady_clock`, cette fonction renvoie donc désormais toujours `true`.

Voir également ` clockType()` et ` QElapsedTimer::ClockType`.

[noexcept] bool QElapsedTimer::isValid() const

Renvoie « false » si le minuteur n'a jamais été lancé ou invalidé par un appel à la fonction ` invalidate()`.

Voir également invalidate(), start() et restart().

[noexcept] qint64 QElapsedTimer::msecsSinceReference() const

Renvoie le nombre de millisecondes écoulées entre le dernier démarrage de cet objet ` QElapsedTimer ` et le début de son horloge de référence.

Ce nombre est généralement arbitraire pour toutes les horloges, à l'exception de l'horloge de type « QElapsedTimer::SystemTime ». Pour ce type d'horloge, ce nombre correspond au nombre de millisecondes écoulées depuis le 1er janvier 1970 à 0 h 00 UTC (il s'agit donc du temps Unix exprimé en millisecondes).

Sur les plateformes Linux, Windows et Apple, cette valeur correspond généralement au temps écoulé depuis le démarrage du système, bien qu’elle n’inclue généralement pas le temps passé par le système en état de veille.

Voir également clockType() et elapsed().

[noexcept] qint64 QElapsedTimer::msecsTo(const QElapsedTimer &other) const

Renvoie le nombre de millisecondes entre cet QElapsedTimer et other. Si other a été lancé avant cet objet, la valeur renvoyée sera négative. S'il a été lancé après, la valeur renvoyée sera positive.

La valeur renvoyée est indéfinie si cet objet ou other ont été invalidés.

Voir également secsTo() et elapsed().

[noexcept] qint64 QElapsedTimer::nsecsElapsed() const

Renvoie le nombre de nanosecondes écoulées depuis le dernier démarrage de cette instance de ` QElapsedTimer `.

L'appel de cette fonction sur une QElapsedTimer non valide entraîne un comportement indéfini.

Sur les plateformes ne prenant pas en charge la résolution en nanosecondes, la valeur renvoyée correspondra à la meilleure estimation disponible.

Voir également start(), restart(), hasExpired() et invalidate().

[noexcept] qint64 QElapsedTimer::restart()

Redémarre le chronomètre et renvoie le nombre de millisecondes écoulées depuis le dernier démarrage. Cette fonction équivaut à obtenir le temps écoulé avec elapsed() puis à redémarrer le chronomètre avec start(), mais elle effectue ces deux opérations en une seule, évitant ainsi de devoir récupérer deux fois la valeur de l’horloge.

L'appel de cette fonction sur une valeur ` QElapsedTimer ` non valide entraîne un comportement indéfini.

L’exemple suivant illustre comment utiliser cette fonction pour calibrer un paramètre en fonction d’une opération lente (par exemple, un nombre d’itérations) afin que cette opération prenne au moins 250 millisecondes :

    QElapsedTimer timer;

    int count = 1;
    timer.start();
    do {
        count *= 2;
        slowOperation2(count);
    } while (timer.restart() < 250);

    return count;

Voir également start(), invalidate(), elapsed() et isValid().

[noexcept] qint64 QElapsedTimer::secsTo(const QElapsedTimer &other) const

Renvoie le nombre de secondes entre cet QElapsedTimer et other. Si other a été lancé avant cet objet, la valeur renvoyée sera négative. S’il a été lancé après, la valeur renvoyée sera positive.

L’appel de cette fonction sur ou avec un objet ` QElapsedTimer ` non valide entraîne un comportement indéfini.

Voir également msecsTo() et elapsed().

[noexcept] void QElapsedTimer::start()

Lance ce minuteur. Une fois lancé, la valeur du minuteur peut être consultée à l'aide de la fonction ` elapsed()` ou ` msecsSinceReference()`.

En règle générale, un minuteur est lancé juste avant une opération longue, telle que :

    QElapsedTimer timer;
    timer.start();

    slowOperation1();

    qDebug() << "The slow operation took" << timer.elapsed() << "milliseconds";

De plus, le fait de démarrer un chronomètre le rend à nouveau valide.

Voir également restart(), invalidate() et elapsed().