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 を使用するため、この関数は常に 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:00UTCからのミリ秒数です（つまり、ミリ秒単位で表現されたUnix時間です）。

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 （）でタイマーを再スタートさせるのと同じであるが、1回の操作でこれを行うため、クロック値を2回取得する必要がない。

無効な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() でタイマーの値をチェックできる。

通常、タイマーは次のような長時間の操作の直前に開始される：

    QElapsedTimertimer; timer.start()；
    slowOperation1();

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

また、タイマーをスタートさせると、再び有効になる。

restart （）、invalidate （）、elapsed （）も参照の こと。