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からの経過ミリ秒数となります（つまり、ミリ秒単位で表された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() を使用して、タイマーの値を確認できます。

通常、タイマーは次のような長時間かかる処理の直前に開始されます。

    QElapsedTimer timer;
    timer.start();

    slowOperation1();

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

また、タイマーを起動すると、再び有効になります。

restart()、invalidate()、およびelapsed()も参照してください 。