QElapsedTimer Class

Dokumentation der Mitgliederfunktionen

[constexpr noexcept] QElapsedTimer::QElapsedTimer()

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

Siehe auch isValid() und start().

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

Gibt den Uhrentyp zurück, den diese QElapsedTimer Implementierung verwendet.

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

Siehe auch isMonotonic().

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

Gibt eine std::chrono::nanoseconds mit der Zeit seit dem letzten Start dieser QElapsedTimer zurück.

Der Aufruf dieser Funktion mit einer QElapsedTimer, die ungültig ist, führt zu undefiniertem Verhalten.

Auf Plattformen, die keine Nanosekunden-Auflösung bieten, ist der zurückgegebene Wert die beste verfügbare 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 zurückgegebene Wert negativ. Wenn es später gestartet wurde, 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 seit dem letzten Start dieser QElapsedTimer zurück.

Der Aufruf dieser Funktion mit einer QElapsedTimer, die ungültig ist, 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 negatives timeout wird als unendlich interpretiert, so dass in diesem Fall false zurückgegeben wird. Andernfalls ist dies äquivalent zu elapsed() > timeout. Sie können dasselbe für eine Dauer tun, indem Sie durationElapsed() mit einer Zeitüberschreitung 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 Zeit, die seit ungültigen Daten verstrichen ist, sind undefiniert und werden wahrscheinlich bizarre Ergebnisse liefern.

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

[static noexcept] bool QElapsedTimer::isMonotonic()

Gibt true zurück, wenn dies eine monotone Uhr ist, andernfalls false. Siehe die Informationen über die verschiedenen Uhrentypen, um zu verstehen, welche monoton sind.

Seit Qt 6.6 verwendet QElapsedTimer std::chrono::steady_clock , so dass diese Funktion nun immer true zurückgibt.

Siehe auch clockType() und QElapsedTimer::ClockType.

[noexcept] bool QElapsedTimer::isValid() const

Gibt false zurück, wenn der Zeitgeber 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.

Diese Zahl ist normalerweise willkürlich für alle Uhren außer der QElapsedTimer::SystemTime Uhr. Für diesen Uhrentyp ist diese Zahl die Anzahl der Millisekunden seit dem 1. Januar 1970 um 0:00 UTC (d.h. es ist die Unix-Zeit in Millisekunden).

Auf Linux-, Windows- und Apple-Plattformen ist dieser Wert in der Regel die Zeit seit dem Systemstart, wobei die Zeit, die das System im Ruhezustand 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. Wurde es später gestartet, ist der Rückgabewert 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 dieser QElapsedTimer zurück.

Der Aufruf dieser Funktion mit einer ungültigen QElapsedTimer führt zu einem undefinierten Verhalten.

Auf Plattformen, die keine Nanosekunden-Auflösung bieten, ist der zurückgegebene Wert die beste verfügbare Schätzung.

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

[noexcept] qint64 QElapsedTimer::restart()

Startet den Zeitgeber neu und gibt die Anzahl der seit dem letzten Start verstrichenen Millisekunden zurück. Diese Funktion entspricht der Ermittlung der verstrichenen Zeit mit elapsed() und dem erneuten Starten des Zeitgebers mit start(), allerdings in einem einzigen Vorgang, so dass der Zeitwert nicht zweimal ermittelt werden muss.

Der Aufruf dieser Funktion mit einer ungültigen QElapsedTimer führt zu einem undefinierten Verhalten.

Das folgende Beispiel veranschaulicht, wie diese Funktion verwendet werden kann, um einen Parameter für eine langsame Operation (z. B. eine Iterationszahl) so zu kalibrieren, dass 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. Wurde es später gestartet, ist der Rückgabewert positiv.

Der Aufruf dieser Funktion auf oder mit einer QElapsedTimer, die ungültig ist, führt zu undefiniertem Verhalten.

Siehe auch msecsTo() und elapsed().

[noexcept] void QElapsedTimer::start()

Startet diesen Zeitgeber. Nach dem Start kann der Wert des Timers mit elapsed() oder msecsSinceReference() überprüft werden.

Normalerweise wird ein Timer kurz vor einer längeren Operation gestartet, wie z.B.:

    QElapsedTimer timer; timer.start();
    slowOperation1();

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

Auch das Starten eines Timers macht ihn wieder gültig.

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