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，从创建该对象时算起。如果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 用户定义的时间字面量（如 in）一起使用：

    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() 和 deadlineNSecs()。

[noexcept] bool QDeadlineTimer::hasExpired() const

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

QDeadlineTimer 使用 创建的对象永远不会过期，因此该函数总是返回 false。ForeverConstant

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

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

如果QDeadlineTimer 对象永不过期，则返回 true，否则返回 false。对于永不过期的计时器，remainingTime() 总是返回 -1，而deadline() 则返回最大值。

另请参见 ForeverConstant,hasExpired() 和remainingTime()。

[noexcept] qint64 QDeadlineTimer::remainingTime() const

返回QDeadlineTimer 对象的剩余时间（毫秒）。如果定时器已过期，则此函数将返回 0，并且无法用此函数获取逾期时间（请参阅deadline() ）。如果定时器被设置为永不过期，则此函数返回-1。

此函数适用于需要毫秒超时的 Qt XML 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 对象的剩余时间（纳秒）。如果定时器已过期，则此函数将返回 0，并且无法通过此函数获得逾期时间。如果定时器被设置为永不过期，则此函数返回-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)

如果secs 为正值，则将QDeadlineTimer 对象的剩余时间设置为secs 秒加上nsecs 纳秒。如果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 用户定义的时间字面量（如 in）一起使用：

    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_ 。