QDeadlineTimer Class

Documentation des fonctions membres

Construit un objet QDeadlineTimer expiré. Pour cet objet, remainingTime() renvoie 0. Si timerType n'est pas défini, l'objet utilisera coarse timer type .

Le type de minuterie timerType peut être ignoré, puisque la minuterie est déjà expirée. De même, à des fins d'optimisation, cette fonction n'essaiera pas d'obtenir l'heure actuelle et utilisera une valeur connue pour être dans le passé. Par conséquent, deadline() peut renvoyer une valeur inattendue et cet objet ne peut pas être utilisé pour calculer la durée du retard. Si cette fonctionnalité est requise, utilisez QDeadlineTimer::current().

Voir également hasExpired(), remainingTime(), Qt::TimerType, et current().

[constexpr noexcept] QDeadlineTimer::QDeadlineTimer(QDeadlineTimer::ForeverConstant, Qt::TimerType timerType = Qt::CoarseTimer)

Les objets QDeadlineTimer créés avec ForeverConstant n'expirent jamais. Pour ces objets, remainingTime() renvoie -1, deadline() renvoie la valeur maximale et isForever() renvoie true.

Le type de minuterie timerType peut être ignoré, puisque la minuterie n'expirera jamais.

Voir aussi ForeverConstant, hasExpired(), isForever(), remainingTime() et timerType().

[explicit noexcept] QDeadlineTimer::QDeadlineTimer(qint64 msecs, Qt::TimerType type = Qt::CoarseTimer)

Construit un objet QDeadlineTimer avec un délai d'expiration de msecs msecs à partir du moment de la création de cet objet, si msecs est positif. Si msecs est égal à zéro, ce QDeadlineTimer sera marqué comme étant expiré, ce qui fera que remainingTime() renverra zéro et deadline() renverra un point de temps indéterminé dans le passé. Si msecs est négatif, la minuterie sera définie comme n'expirant jamais, ce qui signifie que remainingTime() renverra -1 et deadline() renverra la valeur maximale.

L'objet QDeadlineTimer sera construit avec la minuterie spécifiée type.

À des fins d'optimisation, si msecs est égal à zéro, cette fonction peut ne pas obtenir l'heure actuelle et utiliser à la place une valeur connue pour être dans le passé. Dans ce cas, deadline() peut renvoyer une valeur inattendue et cet objet ne peut pas être utilisé pour calculer la durée de son retard. Si cette fonctionnalité est requise, utilisez QDeadlineTimer::current() et ajoutez-y le temps.

Voir aussi hasExpired(), isForever(), remainingTime() et setRemainingTime().

template <typename Rep, typename Period> QDeadlineTimer::QDeadlineTimer(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

Construit un objet QDeadlineTimer avec un temps restant de remaining. Si remaining est nul ou négatif, cet objet QDeadlineTimer sera marqué comme expiré, tandis que si remaining est égal à duration::max(), l'objet sera défini comme n'expirant jamais.

L'objet QDeadlineTimer sera construit avec le timer spécifié type.

Ce constructeur peut être utilisé avec les littéraux définis par l'utilisateur pour le temps en C++14, tels que in :

    using namespace std::chrono_literals;
    QDeadlineTimer deadline(250ms);

À des fins d'optimisation, si remaining est nul ou négatif, cette fonction peut ne pas obtenir l'heure actuelle et utiliser à la place une valeur connue pour être dans le passé. Dans ce cas, deadline() peut renvoyer une valeur inattendue et cet objet ne peut pas être utilisé pour calculer la durée du retard. Si cette fonctionnalité est requise, utilisez QDeadlineTimer::current() et ajoutez-y le temps.

Voir aussi hasExpired(), isForever(), remainingTime() et setRemainingTime().

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer::QDeadlineTimer(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

Construit un objet QDeadlineTimer avec une date limite au point temporel deadline, en convertissant la source d'horloge Clock à la source d'horloge interne de Qt (voir QElapsedTimer::clockType()).

Si deadline est dans le passé, cet objet QDeadlineTimer est défini comme expiré, alors que si deadline est égal à Duration::max(), cet objet est défini comme n'expirant jamais.

L'objet QDeadlineTimer sera construit avec le timer spécifié type.

Voir également hasExpired(), isForever(), remainingTime() et setDeadline().

[static noexcept] QDeadlineTimer QDeadlineTimer::addNSecs(QDeadlineTimer dt, qint64 nsecs)

Renvoie un objet QDeadlineTimer dont le délai est prolongé de nsecs nanosecondes par rapport au délai de dt. Si dt a été configuré pour ne jamais expirer, cette fonction renvoie un objet QDeadlineTimer qui n'expirera pas non plus.

[static noexcept] QDeadlineTimer QDeadlineTimer::current(Qt::TimerType timerType = Qt::CoarseTimer)

Retourne un QDeadlineTimer qui est expiré mais qui est garanti de contenir l'heure actuelle. Les objets créés par cette fonction peuvent participer au calcul de la durée d'expiration d'un minuteur à l'aide de la fonction deadline().

L'objet QDeadlineTimer sera construit avec l'adresse timerType spécifiée.

[noexcept] qint64 QDeadlineTimer::deadline() const

Renvoie le point temporel absolu pour l'échéance stockée dans l'objet QDeadlineTimer, calculé en millisecondes par rapport à l'horloge de référence, de la même manière que QElapsedTimer::msecsSinceReference(). La valeur sera dans le passé si l'objet QDeadlineTimer a expiré.

Si l'objet QDeadlineTimer n'expire jamais, cette fonction renvoie std::numeric_limits<qint64>::max().

Cette fonction peut être utilisée pour calculer le temps de retard d'une minuterie, en soustrayant QDeadlineTimer::current() ou QElapsedTimer::msecsSinceReference(), comme dans l'exemple suivant :

    qint64 realTimeLeft = deadline.deadline();
    if (realTimeLeft != (std::numeric_limits<qint64>::max)()) {
        realTimeLeft -= QDeadlineTimer::current().deadline();
        // or:
        //QElapsedTimer timer;
        //timer.start();
        //realTimeLeft -= timer.msecsSinceReference();
    }

Voir également remainingTime(), deadlineNSecs() et setDeadline().

[noexcept] qint64 QDeadlineTimer::deadlineNSecs() const

Renvoie le point temporel absolu pour l'échéance stockée dans l'objet QDeadlineTimer, calculé en nanosecondes par rapport à l'horloge de référence, de la même manière que QElapsedTimer::msecsSinceReference(). La valeur sera dans le passé si l'objet QDeadlineTimer a expiré.

Si l'objet QDeadlineTimer n'expire jamais ou si le nombre de nanosecondes avant l'échéance ne peut être pris en compte dans le type de retour, cette fonction renvoie std::numeric_limits<qint64>::max().

Cette fonction peut être utilisée pour calculer le temps de retard d'une minuterie, en soustrayant QDeadlineTimer::current(), comme dans l'exemple suivant :

    qint64 realTimeLeft = deadline.deadlineNSecs();
    if (realTimeLeft != std::numeric_limits<qint64>::max())
        realTimeLeft -= QDeadlineTimer::current().deadlineNSecs();

Voir également remainingTime(), deadline() et setDeadline().

[noexcept] bool QDeadlineTimer::hasExpired() const

Retourne vrai si l'objet QDeadlineTimer a expiré, faux s'il reste du temps. Pour les objets qui ont expiré, remainingTime() renvoie zéro et deadline() renvoie un point dans le passé.

QDeadlineTimer Les objets créés avec ForeverConstant n'expirent jamais et cette fonction renvoie toujours false pour eux.

Voir également isForever() et remainingTime().

[constexpr noexcept] bool QDeadlineTimer::isForever() const

Retourne true si cet objet QDeadlineTimer n'expire jamais, false sinon. Pour les minuteries qui n'expirent jamais, remainingTime() renvoie toujours -1 et deadline() renvoie la valeur maximale.

Voir aussi ForeverConstant, hasExpired(), et remainingTime().

[noexcept] qint64 QDeadlineTimer::remainingTime() const

Renvoie le temps restant dans cet objet QDeadlineTimer en millisecondes. Si la minuterie a déjà expiré, cette fonction renvoie zéro et il n'est pas possible d'obtenir le temps de retard avec cette fonction (pour ce faire, voir deadline()). Si la minuterie a été réglée pour ne jamais expirer, cette fonction renvoie -1.

Cette fonction est adaptée à une utilisation dans les API Qt qui prennent un délai de quelques millisecondes, comme les nombreuses fonctions de QIODevice waitFor ou les fonctions de verrouillage temporisé de QMutex, QWaitCondition, QSemaphore, ou QReadWriteLock. Par exemple :

    mutex.tryLock(deadline.remainingTime());

Voir aussi setRemainingTime(), remainingTimeNSecs(), isForever() et hasExpired().

[noexcept] std::chrono::nanoseconds QDeadlineTimer::remainingTimeAsDuration() const

Renvoie le temps restant avant la date limite.

[noexcept] qint64 QDeadlineTimer::remainingTimeNSecs() const

Renvoie le temps restant dans cet objet QDeadlineTimer en nanosecondes. Si la minuterie a déjà expiré, cette fonction renvoie zéro et il n'est pas possible d'obtenir le temps de retard avec cette fonction. Si la minuterie a été configurée pour ne jamais expirer, cette fonction renvoie -1.

Voir aussi remainingTime(), isForever() et hasExpired().

[noexcept] void QDeadlineTimer::setDeadline(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

Définit la date limite pour cet objet QDeadlineTimer comme étant le point de temps absolu msecs, compté en millisecondes depuis l'horloge de référence (identique à QElapsedTimer::msecsSinceReference()), et le type de minuterie à timerType. Si la valeur se situe dans le passé, cet objet QDeadlineTimer sera marqué comme étant expiré.

Si msecs est std::numeric_limits<qint64>::max() ou si l'échéance est au-delà d'un point représentable dans le futur, ce QDeadlineTimer sera défini comme n'expirant jamais.

Voir aussi setPreciseDeadline(), deadline(), deadlineNSecs() et setRemainingTime().

template <typename Clock, typename Duration = typename Clock::duration> void QDeadlineTimer::setDeadline(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

Fixe cet objet QDeadlineTimer à l'échéance marquée par le point temporel deadline, en convertissant la source d'horloge Clock à la source d'horloge interne de Qt (voir QElapsedTimer::clockType()).

Si deadline est dans le passé, cet objet QDeadlineTimer est défini comme expiré, alors que si deadline est égal à Duration::max(), cet objet est défini comme n'expirant jamais.

Le type de minuterie pour cet objet QDeadlineTimer sera défini sur le type spécifié type.

Voir aussi hasExpired(), isForever() et remainingTime().

[noexcept] void QDeadlineTimer::setPreciseDeadline(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

Fixe la date limite pour cet objet QDeadlineTimer à secs secondes et nsecs nanosecondes depuis l'époque de l'horloge de référence (identique à QElapsedTimer::msecsSinceReference()), et le type de minuterie à timerType. Si la valeur est dans le passé, cet objet QDeadlineTimer sera marqué comme étant expiré.

Si secs ou nsecs est std::numeric_limits<qint64>::max(), ce QDeadlineTimer sera défini comme n'expirant jamais. Si nsecs est supérieur à 1 milliard de nanosecondes (1 seconde), secs sera ajusté en conséquence.

Voir aussi setDeadline(), deadline(), deadlineNSecs() et setRemainingTime().

[noexcept] void QDeadlineTimer::setPreciseRemainingTime(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

Fixe le temps restant pour cet objet QDeadlineTimer à secs secondes plus nsecs nanosecondes à partir de maintenant, si secs a une valeur positive. Si secs est négatif, l'objet QDeadlineTimer sera défini comme n'expirant jamais (ce comportement ne s'applique pas à nsecs). Si les deux paramètres sont nuls, QDeadlineTimer sera marqué comme expiré.

À des fins d'optimisation, si secs et nsecs sont tous deux nuls, cette fonction peut ne pas obtenir l'heure actuelle et utiliser à la place une valeur connue pour être dans le passé. Dans ce cas, deadline() peut renvoyer une valeur inattendue et cet objet ne peut pas être utilisé pour calculer la durée de son retard. Si cette fonctionnalité est requise, utilisez QDeadlineTimer::current() et ajoutez-y du temps.

Le type de minuterie pour cet objet QDeadlineTimer sera défini sur le type spécifié timerType.

Voir également setRemainingTime(), hasExpired(), isForever() et remainingTime().

[noexcept] void QDeadlineTimer::setRemainingTime(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

Fixe le temps restant pour cet objet QDeadlineTimer à msecs millisecondes à partir de maintenant, si msecs a une valeur positive. Si msecs est égal à zéro, cet objet QDeadlineTimer sera marqué comme ayant expiré, tandis qu'une valeur négative fera en sorte qu'il n'expirera jamais.

À des fins d'optimisation, si msecs est égal à zéro, cette fonction peut ne pas obtenir l'heure actuelle et utiliser à la place une valeur connue pour être dans le passé. Dans ce cas, deadline() peut renvoyer une valeur inattendue et cet objet ne peut pas être utilisé pour calculer la durée de son retard. Si cette fonctionnalité est requise, utilisez QDeadlineTimer::current() et ajoutez-y du temps.

Le type de minuterie pour cet objet QDeadlineTimer sera défini sur le type spécifié timerType.

Voir aussi setPreciseRemainingTime(), hasExpired(), isForever() et remainingTime().

template <typename Rep, typename Period> void QDeadlineTimer::setRemainingTime(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

Fixe le temps restant pour cet objet QDeadlineTimer à remaining. Si remaining est nul ou négatif, cet objet QDeadlineTimer sera marqué comme expiré, tandis que si remaining est égal à duration::max(), l'objet sera défini comme n'expirant jamais.

Le type de temporisation de l'objet QDeadlineTimer sera défini comme étant le type spécifié type.

Cette fonction peut être utilisée avec les littéraux définis par l'utilisateur pour le temps en C++14, tels que in :

    using namespace std::chrono_literals;
    deadline.setRemainingTime(250ms);

Voir aussi setDeadline(), remainingTime(), hasExpired() et isForever().

void QDeadlineTimer::setTimerType(Qt::TimerType timerType)

Modifie le type de minuterie pour cet objet à timerType.

Le comportement pour chaque valeur possible de timerType dépend du système d'exploitation. Qt::PreciseTimer utilisera la minuterie la plus précise que Qt XML puisse trouver, avec une résolution de 1 milliseconde ou mieux, alors que QDeadlineTimer essaiera d'utiliser une minuterie plus grossière pour Qt::CoarseTimer et Qt::VeryCoarseTimer.

Voir aussi timerType() et Qt::TimerType.

[noexcept] void QDeadlineTimer::swap(QDeadlineTimer &other)

Remplace ce délai par other. Cette opération est très rapide et n'échoue jamais.

[noexcept] Qt::TimerType QDeadlineTimer::timerType() const

Renvoie le type de temporisateur actif pour cet objet.

Voir aussi setTimerType().

QDeadlineTimer &QDeadlineTimer::operator+=(qint64 msecs)

Prolonge cet objet QDeadlineTimer de msecs millisecondes et se renvoie lui-même. Si cet objet est configuré pour ne jamais expirer, cette fonction ne fait rien.

Pour ajouter des temps d'une précision supérieure à 1 milliseconde, utilisez addNSecs().

QDeadlineTimer &QDeadlineTimer::operator-=(qint64 msecs)

Raccourcit cet objet QDeadlineTimer de msecs millisecondes et se renvoie lui-même. Si cet objet est défini comme n'expirant jamais, cette fonction ne fait rien.

Pour soustraire des temps d'une précision supérieure à 1 milliseconde, utilisez addNSecs().

template <typename Rep, typename Period> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::duration<Rep, Period> remaining)

Règle ce délai sur l'heure remaining.

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::time_point<Clock, Duration> deadline_)

Attribue deadline_ à ce délai.