QT中的定时器与计时器

目录

QTimer

QTimer 的替代方案

API

QElapsedTimer

API

笔者写Qt的时候经常遇到需要定时完成任务的情况。举个例子：我写串口通信程序的时候需要定时向下位机发送数据。或者是定时任务周期性出发（更新时间等）

在Qt中，有两个非常常用的类来完成定时操作，请看：

QTimer

QTimer 类提供了一个高级的定时器编程接口。使用时，创建一个 QTimer，将其 timeout() 信号连接到相应的槽，并调用 start()。之后，它将在固定的时间间隔内发射 timeout() 信号。以下是一个一秒（1000 毫秒）定时器的示例（来自模拟钟表示例）：

QTimer *timer = new QTimer(this);
connect(timer, &QTimer::timeout, this, QOverload<>::of(&AnalogClock::update));
timer->start(1000);

从那时起，update() 槽每秒会被调用一次。你可以通过调用 setSingleShot(true) 将定时器设置为只触发一次。你还可以使用静态的 QTimer::singleShot() 函数在指定的时间间隔后调用一个槽：

QTimer::singleShot(200, this, &Foo::updateCaption);

在多线程应用程序中，你可以在任何具有事件循环的线程中使用 QTimer。要从非 GUI 线程启动事件循环，使用 QThread::exec()。Qt 使用定时器的线程亲和性来确定哪个线程将发射 timeout() 信号。因此，必须在其线程中启动和停止定时器；不能从其他线程启动定时器。

在特殊情况下，超时时间为 0 的 QTimer 将尽快超时，但零定时器与其他事件源之间的顺序是未指定的。零定时器可以用于在保持用户界面响应的同时执行一些工作：

QTimer *timer = new QTimer(this);
connect(timer, &QTimer::timeout, this, &Foo::processOneThing);
timer->start();

从那时起，processOneThing() 将被重复调用。它应编写为总是快速返回（通常在处理一条数据项后），以便 Qt 能够向用户界面传递事件，并在完成所有工作后尽快停止定时器。这是实现 GUI 应用程序中重型工作的传统方法，但随着多线程在越来越多的平台上的可用性增加，我们预期零毫秒的 QTimer 对象将逐渐被 QThread 取代。

定时器的精度取决于底层操作系统和硬件。大多数平台支持 1 毫秒的分辨率，尽管在许多实际情况下，定时器的精度可能无法达到这一分辨率。精度也取决于定时器类型。对于 Qt::PreciseTimer，QTimer 将尽力保持 1 毫秒的精度。精确定时器也不会提前超时。

对于 Qt::CoarseTimer 和 Qt::VeryCoarseTimer 类型，QTimer 可能会在预期之前提前唤醒，具体提前的时间范围为这些类型的边界：对于 Qt::CoarseTimer 为间隔的 5%，对于 Qt::VeryCoarseTimer 为 500 毫秒。

所有定时器类型可能会因系统繁忙或无法提供请求的精度而延迟超时。在超时过载的情况下，即使多个超时已经到达，Qt 只会发射一次 timeout()，然后恢复原始的时间间隔。

QTimer 的替代方案

Qt 6.8 引入了 QChronoTimer。这两个类之间的主要区别在于，QChronoTimer 支持更大的时间间隔范围和更高的精度（std::chrono::nanoseconds）。对于 QTimer，最大支持的间隔为 ±24 天，而对于 QChronoTimer 为 ±292 年（对大于 std::numeric_limits<int>::max() 的时间间隔，减少了整数溢出的可能性）。如果你只需要毫秒级的分辨率和 ±24 天的范围，可以继续使用 QTimer。

另一个替代方案是在你的类中重新实现 QObject::timerEvent() 方法（该类必须是 QObject 的子类），并使用以下方法之一：

• 使用 QBasicTimer，这是一个轻量级的值类，封装了定时器 ID。你可以使用 QBasicTimer::start() 启动定时器，并用 QBasicTimer::stop() 停止它。你可以在重新实现的 timerEvent() 中处理事件。

• 更低级的方法是直接操作定时器 ID。启动定时器时调用 QObject::startTimer()，存储返回的 ID。停止定时器时调用 QObject::killTimer()。你可以在重新实现的 timerEvent() 中处理事件。这种方法通常比使用 QBasicTimer 更麻烦。

使用 timerEvent() 的一个缺点是一些高级功能，如单次触发定时器和信号，不受支持。

API

QElapsedTimer

这个玩意是用来实现计时操作的：通常用于快速计算两个事件之间经过的时间。它的 API 与 QTime 类似，因此可以快速将使用 QTime 的代码迁移到这个新类。然而，与 QTime 不同，QElapsedTimer 尽可能使用单调时钟。这意味着无法将 QElapsedTimer 对象转换为人类可读的时间。该类的典型用例是确定在某个缓慢操作中花费了多少时间。最简单的示例是用于调试目的，如下所示：

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

在这个示例中，通过调用 start() 启动计时器，经过的时间通过 elapsed() 函数计算。经过的时间还可以用来重新计算另一项操作可用的时间，这在执行必须在特定时间内完成的多步操作时非常有用。例如，QIODevice 及其子类中的 waitFor 类型函数就是这种需求的良好示例。在这种情况下，代码可以如下：

void executeSlowOperations(int timeout)
{
    QElapsedTimer timer;
    timer.start();
    slowOperation1();
​
    int remainingTime = timeout - timer.elapsed();
    if (remainingTime > 0)
        slowOperation2(remainingTime);
}

另一个用例是为特定的时间片执行某个操作。为此，QElapsedTimer 提供了 hasExpired() 便利函数，可用于判断某些毫秒是否已经过去：

void executeOperationsForTime(int ms)
{
    QElapsedTimer timer;
    timer.start();
​
    while (!timer.hasExpired(ms))
        slowOperation1();
}

在这种情况下，使用 QDeadlineTimer 更为方便，它计算未来的超时，而不是跟踪经过的时间。QElapsedTimer 将在所有支持的平台上使用平台的单调参考时钟（见 QElapsedTimer::isMonotonic()）。这带来了额外的好处，即 QElapsedTimer 对时间调整（例如用户修正时间）是免疫的。与 QTime 不同，QElapsedTimer 也对时区设置的变化（例如夏令时）免疫。

另一方面，这意味着 QElapsedTimer 的值只能与使用相同参考的其他值进行比较。如果从 QElapsedTimer 对象提取的参考时间（QElapsedTimer::msecsSinceReference()）被序列化，这一点尤其重要。这些值不应在网络中交换或保存到磁盘，因为无法确定接收数据的计算机节点是否与原始节点相同，或者是否自那以来已经重启。

然而，确实可以与在同一机器上运行的其他进程交换该值，前提是它们也使用相同的参考时钟。QElapsedTimer 将始终使用相同的时钟，因此与来自同一机器的其他进程的值进行比较是安全的。如果要与其他 API 生成的值进行比较，应该检查使用的时钟是否与 QElapsedTimer 相同（见 QElapsedTimer::clockType()）。

API