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() で確認できる。

通常、タイマーの開始は、.time()などの長時間の操作の直前に行われます：

    QElapsedTimer timer;
    timer.start();

    slowOperation1();

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

また、タイマーを開始すると、そのタイマーは再び有効になります。

restart(),invalidate(),elapsed()も参照のこと 。