QDeadlineTimer Class

Dokumentation der Mitgliedsfunktionen

Konstruiert ein abgelaufenes QDeadlineTimer Objekt. Für dieses Objekt gibt remainingTime() 0 zurück. Wenn timerType nicht gesetzt ist, verwendet das Objekt coarse timer type .

Der Timer-Typ timerType kann ignoriert werden, da der Timer bereits abgelaufen ist. Ebenso versucht diese Funktion aus Optimierungsgründen nicht, die aktuelle Zeit zu ermitteln, 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 für die Berechnung der Überfälligkeit verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie QDeadlineTimer::current().

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

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

QDeadlineTimer-Objekte, die mit ForeverConstant erstellt wurden, laufen nie ab. Für solche Objekte gibt remainingTime() -1 zurück, deadline() gibt den Maximalwert zurück und isForever() gibt true zurück.

Der Timer-Typ timerType kann ignoriert werden, da der Timer nie abläuft.

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

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

Konstruiert ein QDeadlineTimer-Objekt mit einer Verfallszeit von msecs msecs ab dem Zeitpunkt der Erstellung dieses Objekts, falls msecs positiv ist. Wenn msecs gleich Null ist, wird dieser QDeadlineTimer als abgelaufen markiert, wodurch remainingTime() Null und deadline() einen unbestimmten Zeitpunkt in der Vergangenheit zurückgibt. Wenn msecs negativ ist, wird der Timer so eingestellt, dass er nie abläuft, wodurch remainingTime() -1 und deadline() den Maximalwert zurückgibt.

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

Wenn msecs gleich Null ist, kann diese Funktion zu Optimierungszwecken die Ermittlung der aktuellen Zeit überspringen und stattdessen einen Wert verwenden, der bekanntermaßen in der Vergangenheit liegt. In diesem Fall kann deadline() einen unerwarteten Wert zurückgeben, und das Objekt kann nicht für die Berechnung der Überfälligkeit verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie QDeadlineTimer::current() und fügen Sie die Zeit hinzu.

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)

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

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

Dieser Konstruktor kann mit C++14s benutzerdefinierten Literalen für Zeit, wie in, verwendet werden:

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

Wenn remaining Null oder negativ ist, kann diese Funktion zu Optimierungszwecken die aktuelle Zeit auslassen 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älligkeit verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie QDeadlineTimer::current() und fügen Sie die Zeit hinzu.

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)

Konstruiert ein QDeadlineTimer-Objekt mit einer Deadline zum Zeitpunkt deadline und konvertiert von der Zeitquelle Clock in die interne Zeitquelle von Qt (siehe QElapsedTimer::clockType()).

Wenn deadline in der Vergangenheit liegt, wird dieses QDeadlineTimer-Objekt auf abgelaufen gesetzt, wenn deadline gleich Duration::max() ist, wird dieses Objekt auf niemals ablaufend gesetzt.

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 Frist gegenüber dt um nsecs Nanosekunden verlängert ist. Wenn dt so eingestellt wurde, dass es nie abläuft, gibt diese Funktion ein QDeadlineTimer zurück, das ebenfalls nicht abläuft.

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

Gibt eine QDeadlineTimer zurück, die abgelaufen ist, aber garantiert die aktuelle Zeit enthält. Objekte, die mit dieser Funktion erstellt werden, können mit Hilfe der Funktion deadline() an der Berechnung der Überfälligkeit eines Timers teilnehmen.

Das Objekt QDeadlineTimer 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 QElapsedTimer::msecsSinceReference(). Der Wert liegt in der Vergangenheit, wenn diese QDeadlineTimer abgelaufen ist.

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

Diese Funktion kann verwendet werden, um die Zeit zu berechnen, 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 QElapsedTimer::msecsSinceReference(). Der Wert liegt in der Vergangenheit, wenn diese QDeadlineTimer abgelaufen ist.

Wenn diese QDeadlineTimer nie abläuft oder die Anzahl der Nanosekunden bis zur Frist 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, die ein Timer überfällig ist, indem QDeadlineTimer::current() subtrahiert wird, wie im folgenden Beispiel:

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

Siehe auch remainingTime() und deadlineNSecs().

[noexcept] bool QDeadlineTimer::hasExpired() const

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

QDeadlineTimer Objekte, die mit ForeverConstant erstellt wurden, laufen nie ab 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 nie abläuft, andernfalls false. Für Timer, die nie 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, mit dieser Funktion die überfällige Zeit zu ermitteln (siehe deadline()). Wurde der Timer so eingestellt, dass er nie abläuft, gibt diese Funktion -1 zurück.

Diese Funktion eignet sich für die Verwendung in Qt-APIs, die eine Zeitüberschreitung von Millisekunden benötigen, wie z.B. die vielen QIODevice waitFor Funktionen oder die zeitgesteuerten Sperrfunktionen in QMutex, QWaitCondition, QSemaphore, oder QReadWriteLock. Ein 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, mit dieser Funktion die überfällige Zeit zu ermitteln. Wurde der Timer so eingestellt, dass er nie 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)

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

Wenn msecs gleich std::numeric_limits<qint64>::max() ist oder die Frist jenseits eines darstellbaren Punktes in der Zukunft liegt, wird dieser QDeadlineTimer auf nie ablaufend gesetzt.

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 -Objekt auf den durch deadline markierten Zeitpunkt, wobei es von der Uhrquelle Clock in die interne Uhrquelle von Qt konvertiert wird (siehe QElapsedTimer::clockType()).

Wenn deadline in der Vergangenheit liegt, wird dieses QDeadlineTimer Objekt auf abgelaufen gesetzt, wohingegen, wenn deadline gleich Duration::max() ist, dieses Objekt auf nie ablaufend gesetzt wird.

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)

Setzt die Frist für dieses QDeadlineTimer Objekt auf secs Sekunden und nsecs Nanosekunden seit der Referenzuhr-Epoche (das gleiche wie QElapsedTimer::msecsSinceReference()), und den Timer-Typ auf timerType. Wenn der Wert in der Vergangenheit liegt, wird dieses QDeadlineTimer als abgelaufen markiert.

Wenn secs oder nsecs gleich std::numeric_limits<qint64>::max() ist, wird QDeadlineTimer auf nie ablaufend gesetzt. Wenn nsecs länger als 1 Milliarde Nanosekunden (1 Sekunde) ist, 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 Zeit für dieses QDeadlineTimer Objekt auf secs Sekunden plus nsecs Nanosekunden ab jetzt, wenn secs einen positiven Wert hat. Wenn secs negativ ist, wird QDeadlineTimer so eingestellt, dass es nie abläuft (dieses Verhalten gilt nicht für nsecs). Wenn beide Parameter Null sind, wird QDeadlineTimer als abgelaufen markiert.

Aus Optimierungsgründen kann diese Funktion, wenn sowohl secs als auch nsecs Null sind, die Ermittlung 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 das Objekt kann nicht für die Berechnung der Überfälligkeit verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie QDeadlineTimer::current() und fügen Sie die 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 jetzt, wenn msecs einen positiven Wert hat. Wenn msecs gleich Null ist, wird dieses QDeadlineTimer Objekt als abgelaufen markiert, während ein negativer Wert dazu führt, dass es nie abläuft.

Wenn msecs gleich Null ist, kann diese Funktion aus Optimierungsgründen die aktuelle Zeit überspringen und stattdessen einen Wert verwenden, der bekanntermaßen in der Vergangenheit liegt. In diesem Fall kann deadline() einen unerwarteten Wert zurückgeben, und das Objekt kann nicht für die Berechnung der Überfälligkeit verwendet werden. Wenn diese Funktionalität erforderlich ist, verwenden Sie QDeadlineTimer::current() und fügen Sie die Zeit hinzu.

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)

Dies ist eine überladene Funktion.

Setzt die verbleibende Zeit für dieses QDeadlineTimer Objekt auf remaining. Wenn remaining gleich Null oder negativ ist, wird dieses QDeadlineTimer Objekt als abgelaufen markiert, wohingegen, wenn remaining gleich duration::max() ist, das Objekt so eingestellt wird, dass es nie abläuft.

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

Diese Funktion kann mit C++14's benutzerdefinierten Literalen für Zeit, wie z.B. in, verwendet werden:

    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 auf timerType.

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

Siehe auch timerType() und Qt::TimerType.

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

Tauscht diesen Termin mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

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

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

Siehe auch setTimerType().

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

Verlängert dieses QDeadlineTimer Objekt um msecs Millisekunden und gibt sich selbst zurück. Wenn dieses Objekt so eingestellt ist, dass es nie abläuft, tut diese Funktion nichts.

Um Zeiten 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 nie abläuft, tut diese Funktion nichts.

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)

Setzt diesen Termin-Timer auf die Zeit remaining.

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

Weist deadline_ diesem Termin-Timer zu.