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)

msecs가 양수인 경우, 이 객체가 생성된 시점부터 msecs msecs 후 만료되도록 QDeadlineTimer 객체를 생성합니다. msecs 가 0인 경우, 이 QDeadlineTimer는 만료된 것으로 표시되어 remainingTime()가 0을 반환하고, deadline()가 과거의 불확정 시점을 반환하게 됩니다. msecs 가 음수인 경우, 타이머는 만료되지 않도록 설정되며, 이로 인해 remainingTime()는 -1을 반환하고 deadline()는 최대값을 반환합니다.

QDeadlineTimer 객체는 지정된 타이머 type 를 사용하여 생성됩니다.

최적화를 위해, msecs 가 0인 경우 이 함수는 현재 시간을 가져오는 과정을 건너뛰고 대신 과거의 것으로 알려진 값을 사용할 수 있습니다. 이 경우 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 가 0이거나 음수인 경우, 이 QDeadlineTimer 객체는 만료된 것으로 표시되며, remaining 가 duration::max() 와 같을 경우, 해당 객체는 만료되지 않도록 설정됩니다.

QDeadlineTimer 객체는 지정된 타이머 type 로 생성됩니다.

이 생성자는 다음과 같이 C++14의 사용자 정의 시간 리터럴과 함께 사용할 수 있습니다.

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

최적화를 위해, remaining 가 0이거나 음수인 경우, 이 함수는 현재 시간 획득을 건너뛰고 대신 과거로 알려진 값을 사용할 수 있습니다. 이 경우, 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)

deadline 시점의 마감 시간을 가진 QDeadlineTimer 객체를 생성하며, 시계 소스 Clock 를 Qt의 내부 시계 소스로 변환합니다( QElapsedTimer::clockType() 참조).

deadline 가 과거의 시간인 경우, 이 QDeadlineTimer 객체는 만료된 상태로 설정되며, deadline 가 Duration::max() 와 동일한 경우, 이 객체는 만료되지 않는 상태로 설정됩니다.

QDeadlineTimer 객체는 지정된 타이머 type 로 생성됩니다.

hasExpired(), isForever(), remainingTime(), setDeadline()도 참조하십시오 .

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

dt 의 만료 기한을 nsecs 나노초만큼 연장한 QDeadlineTimer 객체를 반환합니다. 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()은 0을 반환하고, 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 객체의 남은 시간을 밀리초 단위로 반환합니다. 타이머가 이미 만료된 경우, 이 함수는 0을 반환하며, 이 함수를 통해 초과된 시간을 확인할 수는 없습니다(이를 확인하려면 deadline()를 참조하십시오). 타이머가 만료되지 않도록 설정된 경우, 이 함수는 -1을 반환합니다.

이 함수는 QIODevice 의 다양한 waitFor 함수나 QMutex, QWaitCondition, QSemaphore, QReadWriteLock 에 있는 시간 제한 잠금 함수와 같이 밀리초 단위의 타임아웃을 사용하는 Qt API에서 사용하기에 적합합니다. 예를 들면 다음과 같습니다:

    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 객체의 만료 시점을 기준 시계 에포크(epoch)로부터 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 의 값이 양수인 경우, 현재 시점으로부터 secs 초와 nsecs 나노초를 더한 값으로 설정합니다. secs 이 음수인 경우, 이 QDeadlineTimer 는 만료되지 않도록 설정됩니다(이 동작은 nsecs 에는 적용되지 않습니다). 두 매개변수가 모두 0인 경우, 이 QDeadlineTimer 는 만료된 것으로 표시됩니다.

최적화를 위해, secs 과 nsecs 이 모두 0인 경우, 이 함수는 현재 시간을 가져오는 과정을 건너뛰고 대신 과거로 알려진 값을 사용할 수 있습니다. 이 경우, deadline()이 예상치 못한 값을 반환할 수 있으며, 이 객체는 기한이 얼마나 지났는지 계산하는 데 사용할 수 없습니다. 해당 기능이 필요한 경우, QDeadlineTimer::current()을 사용하고 시간을 추가하십시오.

이 QDeadlineTimer 객체의 타이머 유형은 지정된 timerType 로 설정됩니다.

setRemainingTime(), hasExpired(), isForever(), remainingTime()도 참조하십시오 .

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

msecs 에 양수 값이 지정된 경우, 이 QDeadlineTimer 객체의 남은 시간을 현재 시점으로부터 msecs 밀리초로 설정합니다. msecs 가 0인 경우, 이 QDeadlineTimer 객체는 만료된 것으로 표시되며, 음수 값을 지정하면 만료되지 않도록 설정됩니다.

최적화를 위해, msecs 가 0인 경우 이 함수는 현재 시간을 가져오는 과정을 건너뛰고 대신 과거의 것으로 알려진 값을 사용할 수 있습니다. 이 경우 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 가 0이거나 음수인 경우, 이 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_ ’를 할당합니다.