QElapsedTimer Class

Dokumentation der Member-Funktionen

[constexpr noexcept default] QElapsedTimer::QElapsedTimer()

Erstellt einen ungültigen QElapsedTimer. Ein Timer wird erst gültig, sobald er gestartet wurde.

Siehe auch isValid() und start().

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

Gibt den Uhrtyp zurück, den diese Implementierung von ` QElapsedTimer ` verwendet.

Seit Qt 6.6 verwendet „ QElapsedTimer “ „ std::chrono::steady_clock “, sodass der Uhrentyp immer „ MonotonicClock “ ist.

Siehe auch ` isMonotonic()`.

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

Gibt einen ` std::chrono::nanoseconds ` zurück, der die Zeit seit dem letzten Start dieses ` QElapsedTimer ` enthält.

Der Aufruf dieser Funktion für einen ungültigen „ QElapsedTimer “ führt zu undefiniertem Verhalten.

Auf Plattformen, die keine Auflösung im Nanosekundenbereich bieten, entspricht der zurückgegebene Wert der bestmöglichen Schätzung.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch start(), restart(), hasExpired() und invalidate().

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

Gibt die Zeitdifferenz zwischen diesem QElapsedTimer und other als std::chrono::nanoseconds zurück. Wenn other vor diesem Objekt gestartet wurde, ist der Rückgabewert negativ. Wurde es später gestartet, ist der Rückgabewert positiv.

Der Rückgabewert ist undefiniert, wenn dieses Objekt oder other ungültig gemacht wurden.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch „ secsTo()“ und „ elapsed()“.

[noexcept] qint64 QElapsedTimer::elapsed() const

Gibt die Anzahl der Millisekunden zurück, die seit dem letzten Start dieses „ QElapsedTimer “ vergangen sind.

Der Aufruf dieser Funktion bei einem ungültigen ` QElapsedTimer ` führt zu undefiniertem Verhalten.

Siehe auch „ start()“, „ restart()“, „ hasExpired()“, „ isValid()“ und „ invalidate()“.

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

Gibt „ true “ zurück, wenn „ elapsed()“ den angegebenen Wert „ timeout “ überschreitet, andernfalls „ false “.

Ein negativer Wert für „ timeout “ wird als unendlich interpretiert, sodass in diesem Fall „ false “ zurückgegeben wird. Andernfalls entspricht dies „ elapsed() > timeout “. Dasselbe können Sie für eine Dauer tun, indem Sie „ durationElapsed()“ mit einem Zeitlimit für die Dauer vergleichen.

Siehe auch elapsed() und QDeadlineTimer.

[noexcept] void QElapsedTimer::invalidate()

Markiert dieses QElapsedTimer -Objekt als ungültig.

Ein ungültiges Objekt kann mit ` isValid()` überprüft werden. Berechnungen der seit dem Auftreten der ungültigen Daten verstrichenen Zeit sind undefiniert und führen wahrscheinlich zu seltsamen Ergebnissen.

Siehe auch „ isValid()“, „ start()“ und „ restart()“.

[static noexcept] bool QElapsedTimer::isMonotonic()

Gibt „ true “ zurück, wenn es sich um eine monotone Uhr handelt, andernfalls „false“. In den Informationen zu den verschiedenen Uhrentypen erfahren Sie, welche davon monoton sind.

Seit Qt 6.6 verwendet ` QElapsedTimer ` ` std::chrono::steady_clock`, sodass diese Funktion nun immer „true“ zurückgibt.

Siehe auch „ clockType()“ und „ QElapsedTimer::ClockType “.

[noexcept] bool QElapsedTimer::isValid() const

Gibt „ false “ zurück, wenn der Timer noch nie gestartet oder durch einen Aufruf von „ invalidate()“ ungültig gemacht wurde.

Siehe auch „ invalidate()“, „ start()“ und „ restart()“.

[noexcept] qint64 QElapsedTimer::msecsSinceReference() const

Gibt die Anzahl der Millisekunden zwischen dem letzten Start dieses QElapsedTimer -Objekts und dem Start seiner Referenzuhr zurück.

Dieser Wert ist in der Regel für alle Uhren außer der „ QElapsedTimer::SystemTime “-Uhr beliebig. Bei diesem Uhrentyp entspricht dieser Wert der Anzahl der Millisekunden seit dem 1. Januar 1970 um 0:00 Uhr UTC (das heißt, es handelt sich um die in Millisekunden ausgedrückte Unix-Zeit).

Auf Linux-, Windows- und Apple-Plattformen entspricht dieser Wert in der Regel der Zeit seit dem Systemstart, wobei die Zeit, die das System in Ruhezuständen verbracht hat, normalerweise nicht berücksichtigt wird.

Siehe auch ` clockType()` und ` elapsed()`.

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

Gibt die Anzahl der Millisekunden zwischen diesem QElapsedTimer und other zurück. Wenn other vor diesem Objekt gestartet wurde, ist der zurückgegebene Wert negativ. Wenn es später gestartet wurde, ist der zurückgegebene Wert positiv.

Der Rückgabewert ist undefiniert, wenn dieses Objekt oder „ other “ ungültig gemacht wurden.

Siehe auch secsTo() und elapsed().

[noexcept] qint64 QElapsedTimer::nsecsElapsed() const

Gibt die Anzahl der Nanosekunden seit dem letzten Start dieses „ QElapsedTimer “ zurück.

Der Aufruf dieser Funktion für einen ungültigen ` QElapsedTimer ` führt zu undefiniertem Verhalten.

Auf Plattformen, die keine Nanosekundenauflösung bieten, entspricht der zurückgegebene Wert der bestmöglichen Schätzung.

Siehe auch start(), restart(), hasExpired() und invalidate().

[noexcept] qint64 QElapsedTimer::restart()

Setzt den Timer zurück und gibt die Anzahl der Millisekunden zurück, die seit dem letzten Start verstrichen sind. Diese Funktion entspricht dem Abrufen der verstrichenen Zeit mit ` elapsed()` und dem anschließenden Neustart des Timers mit ` start()`, führt dies jedoch in einem einzigen Schritt durch, wodurch das zweimalige Abrufen des Uhrwerts entfällt.

Der Aufruf dieser Funktion mit einem ungültigen ` QElapsedTimer ` führt zu undefiniertem Verhalten.

Das folgende Beispiel veranschaulicht, wie diese Funktion verwendet wird, um einen Parameter an eine langsame Operation (z. B. eine Iterationsanzahl) anzupassen, sodass diese Operation mindestens 250 Millisekunden dauert:

    QElapsedTimer timer;

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

    return count;

Siehe auch start(), invalidate(), elapsed() und isValid().

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

Gibt die Anzahl der Sekunden zwischen diesem QElapsedTimer und other zurück. Wenn other vor diesem Objekt gestartet wurde, ist der zurückgegebene Wert negativ. Wenn es später gestartet wurde, ist der zurückgegebene Wert positiv.

Der Aufruf dieser Funktion für oder mit einem ungültigen ` QElapsedTimer ` führt zu undefiniertem Verhalten.

Siehe auch msecsTo() und elapsed().

[noexcept] void QElapsedTimer::start()

Startet diesen Timer. Nach dem Start kann der Timer-Wert mit ` elapsed()` oder ` msecsSinceReference()` abgefragt werden.

Normalerweise wird ein Timer unmittelbar vor einem langwierigen Vorgang gestartet, beispielsweise:

    QElapsedTimer timer;
    timer.start();

    slowOperation1();

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

Außerdem wird der Timer durch das Starten wieder gültig.

Siehe auch restart(), invalidate() und elapsed().