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()는 참을 반환합니다.

타이머 유형 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()는 최대값을 반환합니다.

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

최적화를 위해 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() 과 같으면 이 객체는 만료되지 않도록 설정됩니다.

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

이 생성자는 다음과 같이 시간에 대한 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)

시계 소스 Clock 에서 Qt의 내부 시계 소스로 변환하여 deadline 시점에 기한이 있는 QDeadlineTimer 객체를 생성합니다 ( 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() 및 deadlineNSecs()도 참조하세요 .

[noexcept] bool QDeadlineTimer::hasExpired() const

이 QDeadlineTimer 객체가 만료되면 참을 반환하고, 남은 시간이 있으면 거짓을 반환합니다. 만료된 객체의 경우 remainingTime()는 0을 반환하고 deadline()는 과거의 시점을 반환합니다.

QDeadlineTimer ForeverConstant 로 생성된 객체는 만료되지 않으며 이 함수는 항상 false를 반환합니다.

isForever() 및 remainingTime()도 참조하세요 .

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

이 QDeadlineTimer 객체가 만료되지 않으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다. 만료되지 않는 타이머의 경우 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 개체의 기한을 기준 시계( QElapsedTimer::msecsSinceReference()와 동일)로부터 밀리초 단위로 계산된 msecs 절대 시점으로 설정하고 타이머 유형을 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 객체의 기한을 기준 클록 에포크( QElapsedTimer::msecsSinceReference()와 동일)로부터 secs 초 및 nsecs 나노초로 설정하고 타이머 유형을 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 에는 적용되지 않음). 두 매개변수가 모두 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 은 1 밀리초 이상의 분해능으로 Qt 가 찾을 수 있는 가장 정밀한 타이머를 사용하는 반면, 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_ 을 이 마감 타이머에 할당합니다.