QDeadlineTimer Class

Dokumentation der Member-Funktionen

Erstellt ein abgelaufenes „ QDeadlineTimer “-Objekt. Für dieses Objekt gibt „ remainingTime()“ den Wert 0 zurück. Ist „ timerType “ nicht festgelegt, verwendet das Objekt die „ coarse “ „ timer type “.

Der Timer-Typ „ timerType “ wird möglicherweise ignoriert, da der Timer bereits abgelaufen ist. Aus Optimierungsgründen versucht diese Funktion zudem nicht, die aktuelle Zeit abzurufen, sondern verwendet einen Wert, von dem bekannt ist, dass er in der Vergangenheit liegt. Daher kann ` deadline()` einen unerwarteten Wert zurückgeben, und dieses Objekt kann nicht zur Berechnung der Überfälligkeitsdauer verwendet werden. Wenn diese Funktionalität benötigt wird, verwenden Sie ` QDeadlineTimer::current()`.

Siehe auch hasExpired(), remainingTime(), Qt::TimerType sowie current().

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

Mit „ ForeverConstant “ erstellte „QDeadlineTimer“-Objekte laufen niemals ab. Bei solchen Objekten gibt „ remainingTime()“ den Wert -1 zurück, „ deadline()“ den Maximalwert und „ isForever()“ den Wert „true“.

Der Timer-Typ „ timerType “ kann ignoriert werden, da der Timer niemals abläuft.

Siehe auch ForeverConstant, hasExpired(), isForever(), remainingTime() und timerType().

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

Erstellt ein QDeadlineTimer-Objekt mit einer Ablaufzeit von msecs msecs ab dem Zeitpunkt der Erstellung dieses Objekts, sofern msecs positiv ist. Ist msecs gleich Null, wird dieser QDeadlineTimer als abgelaufen markiert, was dazu führt, dass remainingTime() den Wert Null zurückgibt und deadline() einen unbestimmten Zeitpunkt in der Vergangenheit zurückgibt. Ist ` msecs ` negativ, wird der Timer so eingestellt, dass er niemals abläuft, was dazu führt, dass ` remainingTime()` den Wert -1 und ` deadline()` den Maximalwert zurückgibt.

Das QDeadlineTimer-Objekt wird mit dem angegebenen Timer- type erstellt.

Aus Optimierungsgründen kann diese Funktion, wenn „ msecs “ Null ist, das Abrufen der aktuellen Zeit überspringen und stattdessen einen Wert verwenden, von dem bekannt ist, dass er in der Vergangenheit liegt. In diesem Fall gibt „ deadline()“ möglicherweise einen unerwarteten Wert zurück, und dieses Objekt kann nicht zur Berechnung der Überfälligkeitsdauer verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie „ QDeadlineTimer::current()“ und addieren Sie Zeit dazu.

Siehe auch hasExpired(), isForever(), remainingTime() und setRemainingTime().

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

Erstellt ein `QDeadlineTimer`-Objekt mit einer verbleibenden Zeit von ` remaining`. Ist ` remaining ` gleich Null oder negativ, wird dieses `QDeadlineTimer`-Objekt als abgelaufen markiert, während das Objekt, wenn ` remaining ` gleich ` duration::max()` ist, so eingestellt wird, dass es niemals abläuft.

Das QDeadlineTimer-Objekt wird mit dem angegebenen Timer type erstellt.

Dieser Konstruktor kann mit den benutzerdefinierten Zeitliteralen von C++14 verwendet werden, wie beispielsweise in:

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

Aus Optimierungsgründen kann diese Funktion, wenn ` remaining ` null oder negativ ist, das Abrufen der aktuellen Zeit überspringen und stattdessen einen Wert verwenden, von dem bekannt ist, dass er in der Vergangenheit liegt. In diesem Fall gibt ` deadline()` möglicherweise einen unerwarteten Wert zurück, und dieses Objekt kann nicht zur Berechnung der Überschreitungsdauer verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie ` QDeadlineTimer::current()` und addieren Sie Zeit dazu.

Siehe auch hasExpired(), isForever(), remainingTime() und setRemainingTime().

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

Erstellt ein QDeadlineTimer-Objekt mit einer Frist zum Zeitpunkt „ deadline “ und konvertiert dabei die Uhrquelle „ Clock “ in die interne Uhrquelle von Qt (siehe QElapsedTimer::clockType()).

Liegt deadline in der Vergangenheit, wird dieses QDeadlineTimer-Objekt als abgelaufen gesetzt; ist hingegen deadline gleich Duration::max(), wird dieses Objekt so gesetzt, dass es niemals abläuft.

Das QDeadlineTimer-Objekt wird mit dem angegebenen Timer type erstellt.

Siehe auch hasExpired(), isForever(), remainingTime() und setDeadline().

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

Gibt ein „ QDeadlineTimer “-Objekt zurück, dessen Ablaufdatum gegenüber dem Ablaufdatum von „ dt “ um „ nsecs “ Nanosekunden verlängert wird. Wenn „ dt “ so eingestellt wurde, dass es niemals abläuft, gibt diese Funktion ein „ QDeadlineTimer “-Objekt zurück, das ebenfalls nicht abläuft.

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

Gibt ein ` QDeadlineTimer ` zurück, das zwar abgelaufen ist, aber garantiert die aktuelle Uhrzeit enthält. Mit dieser Funktion erstellte Objekte können mithilfe der Funktion ` deadline()` in die Berechnung der Verspätung eines Timers einbezogen werden.

Das QDeadlineTimer -Objekt wird mit dem angegebenen timerType erstellt.

[noexcept] qint64 QDeadlineTimer::deadline() const

Gibt den absoluten Zeitpunkt für die im Objekt „ QDeadlineTimer “ gespeicherte Frist zurück, berechnet in Millisekunden relativ zur Referenzuhr, genau wie bei „ QElapsedTimer::msecsSinceReference()“. Der Wert liegt in der Vergangenheit, wenn dieses „ QDeadlineTimer “ abgelaufen ist.

Wenn dieses „ QDeadlineTimer “ niemals abläuft, gibt diese Funktion „ std::numeric_limits<qint64>::max() “ zurück.

Diese Funktion kann verwendet werden, um die Zeit zu berechnen, um die ein Timer überfällig ist, indem man QDeadlineTimer::current() oder QElapsedTimer::msecsSinceReference() subtrahiert, wie im folgenden Beispiel:

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

Siehe auch remainingTime(), deadlineNSecs() und setDeadline().

[noexcept] qint64 QDeadlineTimer::deadlineNSecs() const

Gibt den absoluten Zeitpunkt für die im Objekt „ QDeadlineTimer “ gespeicherte Frist zurück, berechnet in Nanosekunden relativ zur Referenzuhr, genau wie bei „ QElapsedTimer::msecsSinceReference()“. Der Wert liegt in der Vergangenheit, wenn dieses „ QDeadlineTimer “ abgelaufen ist.

Wenn dieses ` QDeadlineTimer ` niemals abläuft oder die Anzahl der Nanosekunden bis zum Ablauftermin nicht im Rückgabetyp untergebracht werden kann, gibt diese Funktion ` std::numeric_limits<qint64>::max()` zurück.

Diese Funktion kann verwendet werden, um die Zeit zu berechnen, um die ein Timer überfällig ist, indem QDeadlineTimer::current() abgezogen wird, wie im folgenden Beispiel:

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

Siehe auch „ remainingTime()“, „ deadline()“ und „ setDeadline()“.

[noexcept] bool QDeadlineTimer::hasExpired() const

Gibt „true“ zurück, wenn dieses „ QDeadlineTimer “-Objekt abgelaufen ist, und „false“, wenn noch Zeit verbleibt. Bei abgelaufenen Objekten gibt „ remainingTime()“ den Wert Null zurück, und „ deadline()“ gibt einen Zeitpunkt in der Vergangenheit zurück.

QDeadlineTimer Mit „ ForeverConstant “ erstellte Objekte verfallen nie, und diese Funktion gibt für sie immer „false“ zurück.

Siehe auch isForever() und remainingTime().

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

Gibt „true“ zurück, wenn dieses QDeadlineTimer -Objekt niemals abläuft, andernfalls „false“. Bei Timern, die niemals ablaufen, gibt remainingTime() immer -1 zurück, und deadline() gibt den Maximalwert zurück.

Siehe auch ` ForeverConstant`, ` hasExpired()` und ` remainingTime()`.

[noexcept] qint64 QDeadlineTimer::remainingTime() const

Gibt die verbleibende Zeit in diesem QDeadlineTimer -Objekt in Millisekunden zurück. Wenn der Timer bereits abgelaufen ist, gibt diese Funktion Null zurück, und es ist nicht möglich, die Dauer der Überschreitung mit dieser Funktion zu ermitteln (siehe dazu deadline()). Wenn der Timer so eingestellt wurde, dass er niemals abläuft, gibt diese Funktion -1 zurück.

Diese Funktion eignet sich für den Einsatz in Qt-APIs, die ein Timeout in Millisekunden verwenden, wie beispielsweise die zahlreichen QIODevice - und waitFor -Funktionen oder die Funktionen für zeitgesteuerte Sperren in QMutex, QWaitCondition, QSemaphore oder QReadWriteLock. Zum Beispiel:

    mutex.tryLock(deadline.remainingTime());

Siehe auch setRemainingTime(), remainingTimeNSecs(), isForever() und hasExpired().

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

Gibt die verbleibende Zeit bis zum Ablauf der Frist zurück.

[noexcept] qint64 QDeadlineTimer::remainingTimeNSecs() const

Gibt die verbleibende Zeit in diesem QDeadlineTimer -Objekt in Nanosekunden zurück. Wenn der Timer bereits abgelaufen ist, gibt diese Funktion Null zurück, und es ist nicht möglich, die Dauer der Überschreitung mit dieser Funktion zu ermitteln. Wenn der Timer so eingestellt wurde, dass er niemals abläuft, gibt diese Funktion -1 zurück.

Siehe auch „ remainingTime()“, „ isForever()“ und „ hasExpired()“.

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

Legt die Frist für dieses QDeadlineTimer -Objekt auf den absoluten Zeitpunkt msecs fest, gezählt in Millisekunden ab der Referenzuhr (entspricht QElapsedTimer::msecsSinceReference()), und den Timer-Typ auf timerType. Liegt der Wert in der Vergangenheit, wird dieses QDeadlineTimer als abgelaufen markiert.

Wenn msecs auf std::numeric_limits<qint64>::max() gesetzt ist oder die Frist über einen darstellbaren Zeitpunkt in der Zukunft hinausgeht, wird dieses QDeadlineTimer so eingestellt, dass es niemals abläuft.

Siehe auch setPreciseDeadline(), deadline(), deadlineNSecs() und setRemainingTime().

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

Setzt dieses QDeadlineTimer auf die durch den Zeitpunkt deadline markierte Frist und konvertiert dabei von der Uhrquelle Clock in die interne Uhrquelle von Qt (siehe QElapsedTimer::clockType()).

Liegt deadline in der Vergangenheit, wird dieses QDeadlineTimer -Objekt auf „abgelaufen“ gesetzt; ist hingegen deadline gleich Duration::max(), wird dieses Objekt so eingestellt, dass es niemals abläuft.

Der Timer-Typ für dieses „ QDeadlineTimer “-Objekt wird auf den angegebenen „ type “ gesetzt.

Siehe auch „ hasExpired()“, „ isForever()“ und „ remainingTime()“.

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

Legt die Frist für dieses QDeadlineTimer -Objekt auf secs Sekunden und nsecs Nanosekunden seit der Epoche der Referenzuhr fest (entspricht QElapsedTimer::msecsSinceReference()) und den Timer-Typ auf timerType. Liegt der Wert in der Vergangenheit, wird dieses QDeadlineTimer als abgelaufen markiert.

Wenn „ secs “ oder „ nsecs “ den Wert „ std::numeric_limits<qint64>::max() “ annimmt, wird „ QDeadlineTimer “ so gesetzt, dass es niemals abläuft. Wenn „ nsecs “ mehr als 1 Milliarde Nanosekunden (1 Sekunde) beträgt, wird „ secs “ entsprechend angepasst.

Siehe auch setDeadline(), deadline(), deadlineNSecs() und setRemainingTime().

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

Setzt die verbleibende Laufzeit für dieses „ QDeadlineTimer “-Objekt auf „ secs “ Sekunden plus „ nsecs “ Nanosekunden ab dem aktuellen Zeitpunkt, sofern „ secs “ einen positiven Wert hat. Ist „ secs “ negativ, wird dieses „ QDeadlineTimer “ so eingestellt, dass es niemals abläuft (dieses Verhalten gilt nicht für „ nsecs “). Sind beide Parameter Null, wird dieses „ QDeadlineTimer “ als abgelaufen markiert.

Aus Optimierungsgründen kann diese Funktion, wenn sowohl secs als auch nsecs den Wert Null haben, das Abrufen der aktuellen Uhrzeit überspringen und stattdessen einen Wert verwenden, von dem bekannt ist, dass er in der Vergangenheit liegt. In diesem Fall gibt deadline() möglicherweise einen unerwarteten Wert zurück, und dieses Objekt kann nicht zur Berechnung der Überfälligkeitsdauer verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie QDeadlineTimer::current() und addieren Sie Zeit hinzu.

Der Timer-Typ für dieses ` QDeadlineTimer `-Objekt wird auf den angegebenen ` timerType` gesetzt.

Siehe auch „ setRemainingTime()“, „ hasExpired()“, „ isForever()“ und „ remainingTime()“.

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

Setzt die verbleibende Zeit für dieses „ QDeadlineTimer “-Objekt auf „ msecs “ Millisekunden ab dem aktuellen Zeitpunkt, sofern „ msecs “ einen positiven Wert hat. Ist „ msecs “ gleich Null, wird dieses „ QDeadlineTimer “-Objekt als abgelaufen markiert, während ein negativer Wert bewirkt, dass es niemals abläuft.

Aus Optimierungsgründen kann diese Funktion, wenn msecs gleich Null ist, das Abrufen der aktuellen Zeit überspringen und stattdessen einen Wert verwenden, von dem bekannt ist, dass er in der Vergangenheit liegt. In diesem Fall kann deadline() einen unerwarteten Wert zurückgeben, und dieses Objekt kann nicht zur Berechnung der Überfälligkeitsdauer verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie QDeadlineTimer::current() und addieren Sie Zeit dazu.

Der Timer-Typ für dieses „ QDeadlineTimer “-Objekt wird auf den angegebenen „ timerType “ gesetzt.

Siehe auch „ setPreciseRemainingTime()“, „ hasExpired()“, „ isForever()“ und „ remainingTime()“.

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

Setzt die verbleibende Zeit für dieses „ QDeadlineTimer “-Objekt auf „ remaining “. Ist „ remaining “ gleich Null oder negativ, wird dieses „ QDeadlineTimer “-Objekt als abgelaufen markiert; ist „ remaining “ hingegen gleich „ duration::max() “, wird das Objekt so eingestellt, dass es niemals abläuft.

Der Timer-Typ für dieses QDeadlineTimer -Objekt wird auf den angegebenen type gesetzt.

Diese Funktion kann mit den benutzerdefinierten Zeitliteralen von C++14 verwendet werden, beispielsweise wie folgt:

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

Siehe auch „ setDeadline()“, „ remainingTime()“, „ hasExpired()“ und „ isForever()“.

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

Ändert den Timer-Typ für dieses Objekt in „ timerType “.

Das Verhalten für jeden möglichen Wert von ` timerType ` ist betriebssystemabhängig. ` Qt::PreciseTimer ` verwendet den präzisesten Timer, den Qt finden kann, mit einer Auflösung von 1 Millisekunde oder besser, während ` QDeadlineTimer ` versucht, für ` Qt::CoarseTimer ` und ` Qt::VeryCoarseTimer` einen groberen Timer zu verwenden.

Siehe auch timerType() und Qt::TimerType.

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

Ersetzt diesen Countdown-Timer durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

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

Gibt den Timer-Typ zurück, der für dieses Objekt aktiv ist.

Siehe auch ` setTimerType()`.

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

Erweitert dieses „ QDeadlineTimer “-Objekt um „ msecs “ Millisekunden und gibt sich selbst zurück. Wenn für dieses Objekt festgelegt ist, dass es niemals abläuft, führt diese Funktion keine Aktion aus.

Um Zeitangaben mit einer Genauigkeit von mehr als 1 Millisekunde hinzuzufügen, verwenden Sie ` addNSecs()`.

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

Verkürzt dieses QDeadlineTimer -Objekt um msecs Millisekunden und gibt sich selbst zurück. Wenn dieses Objekt so eingestellt ist, dass es niemals abläuft, führt diese Funktion keine Aktion aus.

Um Zeiten mit einer Genauigkeit von mehr als 1 Millisekunde zu subtrahieren, verwenden Sie ` addNSecs()`.

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

Stellt diesen Zeitmesser auf die Zeit „ remaining “ ein.

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

Weist diesem Fristen-Timer „ deadline_ “ zu.