QElapsedTimer 类

成员函数文档

[constexpr noexcept] QElapsedTimer::QElapsedTimer()

构造一个无效的QElapsedTimer。定时器一旦启动即变为有效。

另请参阅 isValid()和start。

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

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

自Qt 6.6以来，QElapsedTimer使用std::chrono::steady_clock，因此时钟类型始终为MonotonicClock。

另请参阅 isMonotonic。

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

返回自QElapsedTimer上次启动以来时间的std::chrono::nanoseconds。

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

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

此函数是在Qt 6.6中引入的。

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

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

返回这个QElapsedTimer和other之间的时间差，以std::chrono::nanoseconds表示。如果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 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上或与此QElapsedTimer一起调用此函数将产生未定义行为。

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

[noexcept] void QElapsedTimer::start()

启动此计时器。一旦启动，就可以用elapsed()或msecsSinceReference()检查计时器的值。

通常，在耗时操作（例如）之前启动计时器。

    QElapsedTimer timer;
    timer.start();

    slowOperation1();

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

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

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