QDeadlineTimer Class

成员函数文档

构建一个已过期的QDeadlineTimer 对象。对于该对象，remainingTime()将返回0。如果未设置timerType ，则该对象将使用coarse 的timer type 。

计时器类型timerType 可能会被忽略，因为该计时器已过期。同样，出于优化目的，此函数不会尝试获取当前时间，而是会使用一个已知属于过去的值。 因此，deadline() 可能会返回一个意外的值，且该对象无法用于计算逾期时长。如果需要该功能，请使用QDeadlineTimer::current()。

另请参阅 hasExpired()、remainingTime()、Qt::TimerType 以及current()。

[constexpr noexcept] QDeadlineTimer::QDeadlineTimer(QDeadlineTimer::ForeverConstant, Qt::TimerType timerType = Qt::CoarseTimer)

使用 `ForeverConstant ` 创建的 `QDeadlineTimer` 对象永不过期。对于此类对象，`remainingTime()` 将返回 -1，`deadline()` 将返回最大值，而 `isForever()` 将返回 true。

由于该计时器永不过期，因此可以忽略计时器类型timerType 。

另请参阅 ForeverConstant 、hasExpired()、isForever()、remainingTime() 以及timerType()。

[explicit noexcept] QDeadlineTimer::QDeadlineTimer(qint64 msecs, Qt::TimerType type = Qt::CoarseTimer)

创建一个 QDeadlineTimer 对象，其到期时间从该对象创建之时起为msecs 毫秒（若 msecs 为正数）。若msecs 为零，则该 QDeadlineTimer 将被标记为已过期，导致remainingTime() 返回零，而deadline() 返回过去某个未确定的时间点。 如果msecs 为负值，则定时器将设置为永不过期，导致remainingTime()返回-1，而deadline()返回最大值。

QDeadlineTimer 对象将使用指定的计时器type 进行构造。

出于优化目的，如果msecs 为零，该函数可能会跳过获取当前时间，而是使用已知的过去时间值。如果发生这种情况，deadline() 可能会返回一个意外的值，且该对象无法用于计算逾期时间。如果需要此功能，请使用QDeadlineTimer::current() 并向其添加时间。

另请参阅 hasExpired()、isForever()、remainingTime() 和setRemainingTime()。

template <typename Rep, typename Period> QDeadlineTimer::QDeadlineTimer(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

创建一个剩余时间为remaining 的QDeadlineTimer对象。如果remaining 为零或负数，则该QDeadlineTimer对象将被标记为已过期；而如果remaining 等于duration::max() ，则该对象将被设置为永不过期。

QDeadlineTimer 对象将使用指定的定时器type 进行构造。

该构造函数可与C++14 的用户定义时间字面量配合使用，例如：

    using namespace std::chrono_literals;
    QDeadlineTimer deadline(250ms);

出于优化目的，如果remaining 为零或负数，本函数可能会跳过获取当前时间，转而使用已知的过去时间值。如果发生这种情况，deadline() 可能会返回一个意外的值，且该对象无法用于计算逾期时间。如果需要该功能，请使用QDeadlineTimer::current() 并向其添加时间。

另请参阅 hasExpired()、isForever()、remainingTime() 以及setRemainingTime()。

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer::QDeadlineTimer(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

构建一个 QDeadlineTimer 对象，其截止时间设为deadline 时间点，并将时钟源Clock 转换为 Qt 的内部时钟源（参见QElapsedTimer::clockType())。

如果deadline 处于过去，则该 QDeadlineTimer 对象将被设为已过期；而如果deadline 等于Duration::max() ，则该对象将被设为永不过期。

QDeadlineTimer 对象将使用指定的计时器type 进行构造。

另请参阅 hasExpired()、isForever()、remainingTime() 以及setDeadline()。

[static noexcept] QDeadlineTimer QDeadlineTimer::addNSecs(QDeadlineTimer dt, qint64 nsecs)

返回一个QDeadlineTimer 对象，其截止时间在dt 的截止时间基础上延长了nsecs 纳秒。如果dt 被设置为永不过期，则该函数将返回一个同样永不过期的QDeadlineTimer 。

[static noexcept] QDeadlineTimer QDeadlineTimer::current(Qt::TimerType timerType = Qt::CoarseTimer)

返回一个已过期的QDeadlineTimer ，但保证其中包含当前时间。通过此函数创建的对象可参与计算定时器逾期时长，使用deadline()函数。

QDeadlineTimer 对象将根据指定的timerType 进行构建。

[noexcept] qint64 QDeadlineTimer::deadline() const

返回存储在QDeadlineTimer 对象中的截止时间的绝对时间点，以相对于参考时钟的毫秒为单位计算，与QElapsedTimer::msecsSinceReference() 相同。如果该QDeadlineTimer 已过期，则该值将位于过去。

如果该QDeadlineTimer 永不过期，则此函数返回std::numeric_limits<qint64>::max() 。

该函数可用于计算定时器逾期的时间长度，方法是减去QDeadlineTimer::current() 或QElapsedTimer::msecsSinceReference()，如下例所示：

    qint64 realTimeLeft = deadline.deadline();
    if (realTimeLeft != (std::numeric_limits<qint64>::max)()) {
        realTimeLeft -= QDeadlineTimer::current().deadline();
        // or:
        //QElapsedTimer timer;
        //timer.start();
        //realTimeLeft -= timer.msecsSinceReference();
    }

另请参阅 remainingTime()、deadlineNSecs() 和setDeadline()。

[noexcept] qint64 QDeadlineTimer::deadlineNSecs() const

返回存储在QDeadlineTimer 对象中的截止时间的绝对时间点，该时间以纳秒为单位，相对于参考时钟计算，与QElapsedTimer::msecsSinceReference() 相同。如果该QDeadlineTimer 已过期，则返回值将位于过去。

如果该QDeadlineTimer 永不过期，或者距离截止时间的纳秒数超出了返回类型的范围，则该函数返回std::numeric_limits<qint64>::max() 。

该函数可用于计算定时器逾期的时间长度，方法是减去QDeadlineTimer::current()，如下例所示：

    qint64 realTimeLeft = deadline.deadlineNSecs();
    if (realTimeLeft != std::numeric_limits<qint64>::max())
        realTimeLeft -= QDeadlineTimer::current().deadlineNSecs();

另请参阅 remainingTime()、deadline() 和setDeadline()。

[noexcept] bool QDeadlineTimer::hasExpired() const

如果该QDeadlineTimer 对象已过期，则返回true；如果还有剩余时间，则返回false。对于已过期的对象，remainingTime()将返回零，而deadline()将返回过去某个时间点。

QDeadlineTimer 使用 `ForeverConstant ` 创建的对象永不过期，对于此类对象，该函数始终返回 `false`。

另请参阅 isForever() 和remainingTime()。

[constexpr noexcept] bool QDeadlineTimer::isForever() const

如果该QDeadlineTimer 对象永不过期，则返回 true；否则返回 false。对于永不过期的定时器，remainingTime() 始终返回 -1，而deadline() 返回最大值。

另请参阅 ForeverConstant 、hasExpired() 和remainingTime()。

[noexcept] qint64 QDeadlineTimer::remainingTime() const

返回此QDeadlineTimer 对象中剩余的时间（以毫秒为单位）。如果计时器已过期，该函数将返回零，且无法通过此函数获取超时时长（如需获取，请参阅deadline()）。如果计时器被设置为永不过期，该函数将返回 -1。

该函数适用于采用毫秒级超时设置的 Qt API，例如众多QIODevice waitFor 函数，以及QMutex 、QWaitCondition 、QSemaphore 或QReadWriteLock 中的定时锁定函数。例如：

    mutex.tryLock(deadline.remainingTime());

另请参阅 setRemainingTime()、remainingTimeNSecs()、isForever() 和hasExpired() 函数。

[noexcept] std::chrono::nanoseconds QDeadlineTimer::remainingTimeAsDuration() const

返回截止时间前的剩余时间。

[noexcept] qint64 QDeadlineTimer::remainingTimeNSecs() const

返回此QDeadlineTimer 对象中剩余的时间（单位为纳秒）。如果计时器已过期，该函数将返回零，且无法通过该函数获取超时的时间长度。如果计时器被设置为永不过期，该函数将返回-1。

另请参阅 remainingTime()、isForever() 和hasExpired()。

[noexcept] void QDeadlineTimer::setDeadline(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

将此QDeadlineTimer 对象的截止时间设置为msecs （以毫秒为单位，从参考时钟开始计数，与QElapsedTimer::msecsSinceReference()相同），并将计时器类型设置为timerType 。如果该时间点已过去，则此QDeadlineTimer 将被标记为已过期。

如果msecs 为std::numeric_limits<qint64>::max() ，或者截止时间超出了未来可表示的范围，则该QDeadlineTimer 将被设置为永不过期。

另请参阅 setPreciseDeadline()、deadline()、deadlineNSecs() 和setRemainingTime()。

template <typename Clock, typename Duration = typename Clock::duration> void QDeadlineTimer::setDeadline(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

将此QDeadlineTimer 设置为由deadline 时间点标记的截止时间，并将时间源Clock 转换为Qt的内部时间源（参见QElapsedTimer::clockType()）。

如果deadline 处于过去，则该QDeadlineTimer 对象将被设置为已过期；而如果deadline 等于Duration::max() ，则该对象将被设置为永不过期。

该QDeadlineTimer 对象的计时器类型将被设置为指定的type 。

另请参阅 hasExpired()、isForever() 和remainingTime()。

[noexcept] void QDeadlineTimer::setPreciseDeadline(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

将此QDeadlineTimer 对象的截止时间设置为自参考时钟纪元起secs 秒和nsecs 纳秒（与QElapsedTimer::msecsSinceReference() 相同），并将计时器类型设置为timerType 。如果该时间点已过去，则此QDeadlineTimer 将被标记为已过期。

如果secs 或nsecs 的值为std::numeric_limits<qint64>::max() ，则该QDeadlineTimer 将被设置为永不过期。如果nsecs 超过10亿纳秒（1秒），则secs 将相应调整。

另请参阅 setDeadline()、deadline()、deadlineNSecs() 以及setRemainingTime()。

[noexcept] void QDeadlineTimer::setPreciseRemainingTime(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

将该QDeadlineTimer 对象的剩余时间设置为从当前时刻起secs 秒加上nsecs 纳秒；若secs 为正值。若secs 为负值，则该QDeadlineTimer 将被设置为永不过期（此行为不适用于nsecs ）。若两个参数均为零，则该QDeadlineTimer 将被标记为已过期。

出于优化目的，如果secs 和nsecs 均为零，该函数可能会跳过获取当前时间，转而使用已知的过去时间值。如果发生这种情况，deadline() 可能会返回一个意外值，且该对象无法用于计算逾期时间。如果需要该功能，请使用QDeadlineTimer::current() 并向其添加时间。

此QDeadlineTimer 对象的计时器类型将设置为指定的timerType 。

另请参阅 setRemainingTime()、hasExpired()、isForever()，以及remainingTime()。

[noexcept] void QDeadlineTimer::setRemainingTime(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

如果msecs 的值为正，则将此QDeadlineTimer 对象的剩余时间设置为从现在起msecs 毫秒。如果msecs 为零，则此QDeadlineTimer 对象将被标记为已过期；而负值则会将其设置为永不过期。

出于优化目的，如果msecs 为零，本函数可能会跳过获取当前时间，转而使用已知的过去时间值。如果发生这种情况，deadline() 可能会返回一个意外的值，且该对象无法用于计算其逾期时间。如果需要该功能，请使用QDeadlineTimer::current() 并向其添加时间。

此QDeadlineTimer 对象的计时器类型将设置为指定的timerType 。

另请参阅 setPreciseRemainingTime()、hasExpired()、isForever()，以及remainingTime()。

template <typename Rep, typename Period> void QDeadlineTimer::setRemainingTime(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

将此QDeadlineTimer 对象的剩余时间设置为remaining 。如果remaining 为零或负数，则此QDeadlineTimer 对象将被标记为已过期；而如果remaining 等于duration::max() ，则该对象将被设置为永不过期。

该QDeadlineTimer 对象的计时器类型将设置为指定的type 。

该函数可与C++14 的用户定义时间字面量配合使用，例如：

    using namespace std::chrono_literals;
    deadline.setRemainingTime(250ms);

另请参阅 setDeadline()、remainingTime()、hasExpired() 和isForever()。

void QDeadlineTimer::setTimerType(Qt::TimerType timerType)

将该对象的计时器类型更改为timerType 。

timerType 的每个可能值的行为取决于操作系统。Qt::PreciseTimer 将使用 Qt 能找到的最精确的定时器，其分辨率为 1 毫秒或更高；而QDeadlineTimer 则会尝试使用分辨率更粗的定时器，适用于Qt::CoarseTimer 和Qt::VeryCoarseTimer 。

另请参阅 timerType() 和Qt::TimerType 。

[noexcept] void QDeadlineTimer::swap(QDeadlineTimer &other)

将此截止时间计时器替换为other 。此操作速度极快，且绝不会失败。

[noexcept] Qt::TimerType QDeadlineTimer::timerType() const

返回该对象当前处于活动状态的定时器类型。

另请参阅 setTimerType()。

QDeadlineTimer &QDeadlineTimer::operator+=(qint64 msecs)

将此QDeadlineTimer 对象的生存时间延长msecs 毫秒，并返回该对象本身。如果该对象被设置为永不过期，则此函数不执行任何操作。

若需添加精度高于 1 毫秒的时间，请使用addNSecs()。

QDeadlineTimer &QDeadlineTimer::operator-=(qint64 msecs)

将此QDeadlineTimer 对象的剩余时间缩短msecs 毫秒，并返回该对象本身。如果此对象设置为永不过期，则该函数不执行任何操作。

若要减去精度大于 1 毫秒的时间，请使用addNSecs()。

template <typename Rep, typename Period> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::duration<Rep, Period> remaining)

将此截止时间计时器设置为remaining 时间。

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::time_point<Clock, Duration> deadline_)

将deadline_ 分配给此截止时间计时器。