QElapsedTimer Class

멤버 함수 문서

[constexpr noexcept] 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 을 사용하므로 이제 이 함수는 항상 참을 반환합니다.

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 이후의 밀리초 수입니다(즉, 밀리초로 표시된 유닉스 시간입니다).

Linux, Windows 및 Apple 플랫폼에서 이 값은 일반적으로 시스템 부팅 이후의 시간이지만, 일반적으로 시스템이 절전 상태에서 보낸 시간은 포함되지 않습니다.

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()도 참조하세요 .