QElapsedTimer Class

成员函数文档

[constexpr noexcept] QElapsedTimer::QElapsedTimer()

构造一个无效的 QElapsedTimer。定时器一旦启动就会生效。

另请参阅 isValid() 和start()。

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

返回QElapsedTimer 实现使用的时钟类型。

自 Qt XML 6.6 起，QElapsedTimer 使用std::chrono::steady_clock ，因此时钟类型始终是MonotonicClock 。

另请参阅 isMonotonic() 。

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

Returns astd::chrono::nanoseconds with the time since thisQElapsedTimer was last started.

在无效的QElapsedTimer 上调用此函数将导致未定义的行为。

在不提供纳秒分辨率的平台上，返回的值将是可用的最佳估计值。

此函数在 Qt 6.6 中引入。

另请参阅 start()、restart()、hasExpired() 和invalidate()。

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

以std::chrono::nanoseconds 的形式返回该QElapsedTimer 与other 之间的时间差。如果other 在该对象之前启动，返回值将为负数。如果在此之后启动，则返回值为正数。

如果此对象或other 已失效，则返回值未定义。

此函数在 Qt 6.6 中引入。

另请参阅 secsTo() 和elapsed()。

[noexcept] qint64 QElapsedTimer::elapsed() const

返回QElapsedTimer 上次启动后的毫秒数。

在无效的QElapsedTimer 上调用此函数将导致未定义的行为。

另请参阅 start()、restart()、hasExpired()、isValid() 和invalidate()。

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

如果elapsed() 超过给定的timeout ，则返回true ，否则返回false 。

负数timeout 会被解释为无限，因此在这种情况下会返回false 。否则，返回值等同于elapsed() > timeout 。您可以通过比较durationElapsed() 和超时持续时间，对持续时间做同样的处理。

另请参阅 elapsed() 和QDeadlineTimer 。

[noexcept] void QElapsedTimer::invalidate()

将QElapsedTimer 对象标记为无效。

可以使用isValid() 检查无效对象。计算无效数据后的计时时间是未定义的，可能会产生奇怪的结果。

另请参阅 isValid()、start() 和restart()。

[static noexcept] bool QElapsedTimer::isMonotonic()

如果是单调时钟，则返回true ，否则返回 false。请参阅有关不同时钟类型的信息，了解哪些是单调时钟。

自 Qt XML 6.6 起，QElapsedTimer 使用std::chrono::steady_clock ，因此此函数现在总是返回 true。

另请参阅 clockType() 和QElapsedTimer::ClockType 。

[noexcept] bool QElapsedTimer::isValid() const

如果计时器从未启动或调用invalidate() 后无效，则返回false 。

另请参阅 invalidate()、start() 和restart()。

[noexcept] qint64 QElapsedTimer::msecsSinceReference() const

返回QElapsedTimer 对象上次启动时间与其参考时钟启动时间之间的毫秒数。

对于所有时钟（QElapsedTimer::SystemTime 时钟除外）来说，这个毫秒数通常是任意的。对于该时钟类型，这个数字是自 1970 年 1 月 1 日 0:00 UTC 起的毫秒数（即以毫秒表示的 Unix 时间）。

在 Linux、Windows 和 Apple 平台上，该值通常是系统启动后的时间，但通常不包括系统在睡眠状态下的时间。

另请参阅 clockType() 和elapsed()。

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

返回QElapsedTimer 和other 之间的毫秒数。如果other 在此对象之前启动，返回值将为负数。如果在此之后启动，则返回值为正数。

如果此对象或other 已失效，则返回值未定义。

另请参见 secsTo() 和elapsed()。

[noexcept] qint64 QElapsedTimer::nsecsElapsed() const

返回QElapsedTimer 上次启动后的纳秒数。

在QElapsedTimer 无效时调用此函数会导致未定义的行为。

在不提供纳秒分辨率的平台上，返回值将是可用的最佳估计值。

另请参阅 start()、restart()、hasExpired() 和invalidate()。

[noexcept] qint64 QElapsedTimer::restart()

重新启动定时器，并返回自上次启动后的毫秒数。该函数等同于使用elapsed() 获取经过的时间，然后使用start() 再次启动定时器，但它只需一次操作，避免了两次获取时钟值的需要。

在无效的QElapsedTimer 上调用该函数会导致未定义的行为。

下面的示例说明了如何使用该函数来校准慢速操作（例如迭代计数）的参数，使该操作至少需要 250 毫秒：

    QElapsedTimer timer;

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

    return count;

另请参阅 start()、invalidate()、elapsed() 和isValid()。

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

返回QElapsedTimer 和other 之间的秒数。如果other 在此对象之前启动，返回值将为负数。如果在此之后启动，则返回值为正数。

在QElapsedTimer 上或使用无效的 调用此函数将导致未定义的行为。

另请参阅 msecsTo() 和elapsed()。

[noexcept] void QElapsedTimer::start()

启动该计时器。启动后，可以使用elapsed() 或msecsSinceReference() 检查定时器值。

通常情况下，定时器是在进行冗长的操作前启动的，例如："......"：

    QElapsedTimertimer; timer.start()；
    slowOperation1();

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

此外，启动计时器可使其再次有效。

另请参阅 restart()、invalidate() 和elapsed()。