QElapsedTimer Class

成员函数文档

[constexpr noexcept default] 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

返回一个std::chrono::nanoseconds ，其中包含自该QElapsedTimer 上次启动以来经过的时间。

若对无效的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 ` 调用此函数，将导致未定义的行为。

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

[noexcept] void QElapsedTimer::start()

启动此计时器。启动后，可通过elapsed() 或msecsSinceReference() 获取计时器值。

通常，会在执行耗时较长的操作之前启动计时器，例如：

    QElapsedTimer timer;
    timer.start();

    slowOperation1();

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

此外，启动计时器后，该消息将再次生效。

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