QElapsedTimer Class

멤버 함수 설명서

[constexpr noexcept default] QElapsedTimer::QElapsedTimer()

유효하지 않은 QElapsedTimer 객체를 생성합니다. 타이머는 시작되면 유효해집니다.

isValid() 및 start()도 참조하십시오 .

[static noexcept] QElapsedTimer::ClockType QElapsedTimer::clockType()

이 QElapsedTimer 구현체가 사용하는 시계 유형을 반환합니다.

Qt 6.6부터 ` QElapsedTimer `는 ` std::chrono::steady_clock`를 사용하므로, 시계 유형은 항상 ` MonotonicClock`입니다.

isMonotonic()도 참조하십시오 .

[noexcept, since 6.6] QElapsedTimer::Duration QElapsedTimer::durationElapsed() const

이 ` QElapsedTimer `가 마지막으로 시작된 시점부터 경과한 시간을 포함하는 ` std::chrono::nanoseconds `를 반환합니다.

유효하지 않은 QElapsedTimer 에 대해 이 함수를 호출하면 정의되지 않은 동작이 발생합니다.

나노초 단위의 해상도를 제공하지 않는 플랫폼에서는 반환되는 값이 가능한 한 가장 정확한 추정값이 됩니다.

이 함수는 Qt 6.6에서 도입되었습니다.

start(), restart(), hasExpired() 및 invalidate()도 참조하십시오 .

[noexcept, since 6.6] QElapsedTimer::Duration QElapsedTimer::durationTo(const QElapsedTimer &other) const

이 QElapsedTimer 와 other 사이의 시간 차이를 std::chrono::nanoseconds 형식으로 반환합니다. other 가 이 객체보다 먼저 시작된 경우, 반환 값은 음수가 됩니다. 가 이 객체보다 나중에 시작된 경우, 반환 값은 양수가 됩니다.

이 객체나 other 가 무효화된 경우 반환 값은 정의되지 않습니다.

이 함수는 Qt 6.6에서 도입되었습니다.

secsTo() 및 elapsed()도 참조하십시오 .

[noexcept] qint64 QElapsedTimer::elapsed() const

이 QElapsedTimer 가 마지막으로 시작된 이후 경과한 시간을 밀리초 단위로 반환합니다.

유효하지 않은 ` QElapsedTimer `에 대해 이 함수를 호출하면 정의되지 않은 동작이 발생합니다.

start(), restart(), hasExpired(), isValid() 및 invalidate()도 참조하십시오 .

[noexcept] bool QElapsedTimer::hasExpired(qint64 timeout) const

elapsed()의 결과가 주어진 timeout 을 초과하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

음수의 timeout 는 무한대로 해석되므로, 이 경우 false 가 반환됩니다. 그렇지 않은 경우, 이는 elapsed() > timeout 와 동일합니다. durationElapsed()을 지속 시간 타임아웃과 비교하여 지속 시간에 대해서도 동일한 작업을 수행할 수 있습니다.

elapsed() 및 QDeadlineTimer도 참조하십시오 .

[noexcept] void QElapsedTimer::invalidate()

이 QElapsedTimer 객체를 무효로 표시합니다.

무효 객체는 isValid()을 사용하여 확인할 수 있습니다. 무효 데이터가 사용된 이후 경과된 타이머에 대한 계산 결과는 정의되지 않으며, 이상한 결과가 나올 가능성이 높습니다.

isValid(), start(), restart()도 참조하십시오 .

[static noexcept] bool QElapsedTimer::isMonotonic()

이 클럭이 단조 클럭인 경우 true 를 반환하고, 그렇지 않은 경우 false를 반환합니다. 어떤 클럭이 단조 클럭인지 파악하려면 다양한 클럭 유형에 대한 정보를 참조하십시오.

Qt 6.6부터 ` QElapsedTimer `는 ` std::chrono::steady_clock`를 사용하므로, 이 함수는 이제 항상 `true`를 반환합니다.

clockType() 및 QElapsedTimer::ClockType도 참조하십시오 .

[noexcept] bool QElapsedTimer::isValid() const

타이머가 한 번도 시작되지 않았거나 invalidate() 호출로 무효화되지 않은 경우 false 를 반환합니다.

invalidate(), start() 및 restart()도 참조하십시오 .

[noexcept] qint64 QElapsedTimer::msecsSinceReference() const

이 QElapsedTimer 객체가 마지막으로 시작된 시점과 해당 참조 시계의 시작 시점 사이의 시간을 밀리초 단위로 반환합니다.

이 값은 QElapsedTimer::SystemTime 시계를 제외한 모든 시계에서는 일반적으로 임의의 값입니다. 해당 시계 유형의 경우, 이 값은 1970년 1월 1일 0:00 UTC부터 경과한 밀리초 수입니다(즉, 밀리초 단위로 표현된 유닉스 시간입니다).

리눅스, 윈도우 및 애플 플랫폼에서 이 값은 일반적으로 시스템 부팅 이후의 시간을 나타내지만, 시스템이 절전 상태에 있었던 시간은 포함되지 않는 경우가 많습니다.

clockType() 및 elapsed()도 참조하십시오 .

[noexcept] qint64 QElapsedTimer::msecsTo(const QElapsedTimer &other) const

이 QElapsedTimer 와 other 사이의 경과 시간을 밀리초 단위로 반환합니다. other 가 이 객체보다 먼저 시작된 경우, 반환 값은 음수가 됩니다. 가 이 객체보다 나중에 시작된 경우, 반환 값은 양수가 됩니다.

이 객체나 other 이 무효화된 경우 반환 값은 정의되지 않습니다.

secsTo() 및 elapsed()도 참조하십시오 .

[noexcept] qint64 QElapsedTimer::nsecsElapsed() const

이 QElapsedTimer 가 마지막으로 시작된 이후 경과한 나노초 수를 반환합니다.

유효하지 않은 QElapsedTimer 에 대해 이 함수를 호출하면 정의되지 않은 동작이 발생합니다.

나노초 단위의 해상도를 제공하지 않는 플랫폼에서는 반환되는 값이 이용 가능한 최선의 추정값이 됩니다.

start(), restart(), hasExpired(), invalidate()도 참조하십시오 .

[noexcept] qint64 QElapsedTimer::restart()

타이머를 다시 시작하고, 이전 시작 시점부터 경과한 시간을 밀리초 단위로 반환합니다. 이 함수는 elapsed()로 경과 시간을 확인한 후 start()로 타이머를 다시 시작하는 것과 동일하지만, 이를 단일 연산으로 수행하므로 시계 값을 두 번 확인할 필요가 없습니다.

무효한 QElapsedTimer 에 대해 이 함수를 호출하면 정의되지 않은 동작이 발생합니다.

다음 예제는 이 함수를 사용하여 느린 작업(예: 반복 횟수)에 대한 매개변수를 보정하여, 해당 작업이 최소 250밀리초가 소요되도록 하는 방법을 보여줍니다:

    QElapsedTimer timer;

    int count = 1;
    timer.start();
    do {
        count *= 2;
        slowOperation2(count);
    } while (timer.restart() < 250);

    return count;

start(), invalidate(), elapsed(), isValid()도 참조하십시오 .

[noexcept] qint64 QElapsedTimer::secsTo(const QElapsedTimer &other) const

이 ` QElapsedTimer `와 ` other` 사이의 시간(초)을 반환합니다. ` other `가 이 객체보다 먼저 시작된 경우, 반환 값은 음수가 됩니다. 이 객체보다 나중에 시작된 경우, 반환 값은 양수가 됩니다.

유효하지 않은 QElapsedTimer 에 대해 이 함수를 호출하면 정의되지 않은 동작이 발생합니다.

msecsTo() 및 elapsed()도 참조하십시오 .

[noexcept] void QElapsedTimer::start()

이 타이머를 시작합니다. 시작되면 elapsed() 또는 msecsSinceReference()를 사용하여 타이머 값을 확인할 수 있습니다.

일반적으로 타이머는 다음과 같이 시간이 오래 걸리는 작업이 시작되기 직전에 시작됩니다:

    QElapsedTimer timer;
    timer.start();

    slowOperation1();

    qDebug() << "The slow operation took" << timer.elapsed() << "milliseconds";

또한, 타이머를 시작하면 다시 유효해집니다.

restart(), invalidate(), elapsed()도 참조하십시오 .