QDeadlineTimer理论总结

• 一、概述
• 二、使用方式
• 三、参考时钟
• 四、计时器类型
• 五、std::长期的兼容性

一、概述

QDeadlineTimer类通常用于计算未来的截止时间，并验证截止时间是否已经过期。QDeadlineTimer还可以用于没有到期的截止日期(“永远”)。它与QElapsedTimer相对应，后者计算自 QElapsedTimer::start() 被调用以来已经过去了多长时间。
与 QElapsedTimer::hasExpired() 相比，QDeadlineTimer提供了更方便的API。

个人感觉有点像QTimer，但是还是有区别的，QTimer是有回调的函数功能，这个是只是计算时间，是一个属性类。

二、使用方式

该类的典型用例是在操作开始之前创建一个QDeadlineTimer，然后使用 remainingTime() 或 hasExpired() 来确定是否继续尝试操作，这个函数返回值就是说明了 这个是不是超时了。QDeadlineTimer对象可以传递给正在被调用来执行此操作的函数，以便它们知道还需要多长时间。

void executeOperation(int msecs)
{QDeadlineTimer deadline(msecs);do {if (readFromDevice(deadline.remainingTime())break;waitForReadyRead(deadline);} while (!deadline.hasExpired());
}

许多QDeadlineTimer函数处理超时值，这些值都以毫秒为单位。有两个特殊的值，和其他Qt函数waitFor或类似的值一样。

• 0：没有时间了，过期了
• -1：剩余时间无限，定时器永远不会过期

在 remainingTime() 中，返回QDeadlineTimer对象中的剩余时间，结果以毫秒为单位。如果定时器已经过期，这个函数将返回0，并且用这个函数无法获得过期的时间(要做到这一点，请参见deadline())。如果定时器设置为永不到期，则该函数返回-1。

这个函数适合在需要毫秒超时的Qt api中使用，比如很多QIODevice waitFor函数，或者QMutex、QWaitCondition、QSemaphore或QReadWriteLock中的计时锁函数。例如:

mutex.tryLock (deadline.remainingTime ());

三、参考时钟

QDeadlineTimer将使用与QElapsedTimer相同的时钟，就是用的系统的时钟，而不是网络上的时钟。

四、计时器类型

与QTimer类似，QDeadlineTimer可以在定时器的不同粗糙程度之间进行选择。你可以通过向函数传递Qt::PreciseTimer来选择精确计时，也可以通过传递Qt::CoarseTimer来选择粗定时。Qt::VeryCoarseTimer目前的解释方式与Qt::CoarseTimer相同。

此功能依赖于操作系统的支持:如果操作系统不支持粗定时器功能，那么QDeadlineTimer将表现为Qt::PreciseTimer被传递。

QDeadlineTimer默认为Qt::CoarseTimer，因为在支持粗定时的操作系统上，对时钟源进行定时调用通常更有效。粗糙程度取决于操作系统，但应该在几毫秒左右。

五、std::长期的兼容性

QDeadlineTimer与c++ 11中的std::chrono API兼容，可以用std::chrono::duration和std::chrono::time_point对象来构造或比较它们。此外，它完全兼容c++ 14中的时间字面量，允许编写如下代码:

using namespace std::chrono;
using namespace std::chrono_literals;QDeadlineTimer deadline(30s);
device->waitForReadyRead(deadline);
if (deadline.remainingTime() > 300ms)cleanup();

从上面的例子可以看出，QDeadlineTimer提供了remainingTime()和deadline()的模板版本，可以用来返回std::chrono对象。

请注意，与time_point比较的效率不如与duration比较的效率高，因为QDeadlineTimer可能需要将自己的内部时钟源转换为time_point对象使用的时钟源。还要注意的是，由于这种转换，截止日期将不精确，因此下面的代码不能相同地比较:

using namespace std::chrono;
using namespace std::chrono_literals;
auto now = steady_clock::now();
QDeadlineTimer deadline(now + 1s);
Q_ASSERT(deadline == now + 1s);