QDeadlineTimer Class

メンバ関数 ドキュメント

期限切れのQDeadlineTimer オブジェクトを構築する。このオブジェクトの場合、remainingTime() は 0 を返す。timerType が設定されていない場合、オブジェクトはcoarse timer type を使用します。

タイマーはすでに期限切れなので、タイマー・タイプtimerType は無視してもよい。同様に、最適化のため、この関数は現在時刻の取得を試みず、過去の値を使用する。したがって、deadline （）は予期しない値を返す可能性があり、このオブジェクトを期限切れ時間の計算に使用することはできない。そのような機能が必要な場合は、QDeadlineTimer::current() を使用してください。

hasExpired()、remainingTime()、Qt::TimerType 、current()も参照してください 。

[constexpr noexcept] QDeadlineTimer::QDeadlineTimer(QDeadlineTimer::ForeverConstant, Qt::TimerType timerType = Qt::CoarseTimer)

ForeverConstant で作成された QDeadlineTimer オブジェクトに期限はありません。このようなオブジェクトの場合、remainingTime() は -1、deadline() は最大値、isForever() は true を返します。

タイマー・タイプtimerType は無視してもよい。

ForeverConstant 、hasExpired()、isForever()、remainingTime()、timerType()も参照してください 。

[explicit noexcept] QDeadlineTimer::QDeadlineTimer(qint64 msecs, Qt::TimerType type = Qt::CoarseTimer)

msecs が正の値である場合、このオブジェクトが生成された時点からmsecs msecs の有効期限を持つ QDeadlineTimer オブジェクトを構築します。msecs がゼロの場合、この QDeadlineTimer は期限切れとしてマークされ、remainingTime() はゼロを返し、deadline() は過去の不確定な時点を返します。msecs が負の場合、タイマーは期限切れにならないように設定され、remainingTime() は -1 を返し、deadline() は最大値を返します。

QDeadlineTimer オブジェクトは、指定されたタイマーtype で構築されます。

最適化のため、msecs がゼロの場合、この関数は現在時刻の取得を省略し、代わりに過去の既知の値を使用することがあります。その場合、deadline() は予期しない値を返すことがあり、このオブジェクトを期限切れ時間の計算に使用することはできません。そのような機能が必要な場合は、QDeadlineTimer::current() を使用し、それに時間を追加してください。

hasExpired(),isForever(),remainingTime(),setRemainingTime()も参照してください 。

template <typename Rep, typename Period> QDeadlineTimer::QDeadlineTimer(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

残り時間がremaining の QDeadlineTimer オブジェクトを構築します。remaining がゼロまたは負の場合、この QDeadlineTimer オブジェクトは期限切れとしてマークされます。一方、remaining がduration::max() と等しい場合、このオブジェクトは期限切れにならないように設定されます。

QDeadlineTimer オブジェクトは、指定されたタイマーtype で構築されます。

このコンストラクタは、in などの C++14 のユーザー定義時間リテラルとともに使用できます：

    using namespace std::chrono_literals;
    QDeadlineTimer deadline(250ms);

最適化のため、remaining がゼロまたは負の場合、この関数は現在時刻の取得を省略し、代わりに過去の既知の値を使用することがあります。その場合、deadline （）は予期しない値を返し、このオブジェクトを期限切れ時間の計算に使用できないことがある。そのような機能が必要な場合は、QDeadlineTimer::current() を使用し、それに時間を追加してください。

hasExpired(),isForever(),remainingTime(),setRemainingTime()も参照 。

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer::QDeadlineTimer(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

Clock のクロック・ソースから Qt の内部クロック・ソース（QElapsedTimer::clockType() を参照）に変換して、deadline 時点のデッドラインを持つ QDeadlineTimer オブジェクトを構築します。

deadline が過去の場合、この QDeadlineTimer オブジェクトは期限切れに設定され、deadline がDuration::max() と等しい場合、このオブジェクトは期限切れにならないように設定されます。

QDeadlineTimer オブジェクトは、指定されたタイマーtype で構築されます。

hasExpired(),isForever(),remainingTime(),setDeadline()も参照 。

[static noexcept] QDeadlineTimer QDeadlineTimer::addNSecs(QDeadlineTimer dt, qint64 nsecs)

dt の期限からnsecs ナノ秒延長された期限を持つQDeadlineTimer オブジェクトを返します。dt が期限切れにならないように設定されていた場合、この関数は期限切れにならないQDeadlineTimer を返す。

[static noexcept] QDeadlineTimer QDeadlineTimer::current(Qt::TimerType timerType = Qt::CoarseTimer)

期限切れだが、現在時刻を含むことが保証されているQDeadlineTimer を返す。この関数で生成されたオブジェクトは、deadline （）関数を使用して、タイマーの期限切れ時間の計算に参加することができます。

QDeadlineTimer オブジェクトは、指定されたtimerType で構築される。

[noexcept] qint64 QDeadlineTimer::deadline() const

QElapsedTimer::msecsSinceReference() と同じように、基準クロックからの相対ミリ秒単位で計算された、QDeadlineTimer オブジェクトに格納された期限の絶対時点を返します。このQDeadlineTimer が期限切れの場合、値は過去になります。

このQDeadlineTimer が期限切れでない場合、この関数はstd::numeric_limits<qint64>::max() を返す。

この関数は、以下の例のように、QDeadlineTimer::current （）またはQElapsedTimer::msecsSinceReference （）を引くことで、タイマーが期限を過ぎている時間を計算するために使用することができます：

    qint64 realTimeLeft = deadline.deadline();
    if (realTimeLeft != (std::numeric_limits<qint64>::max)()) {
        realTimeLeft -= QDeadlineTimer::current().deadline();
        // or:
        //QElapsedTimer timer;
        //timer.start();
        //realTimeLeft -= timer.msecsSinceReference();
    }

remainingTime(),deadlineNSecs(),setDeadline()も参照 。

[noexcept] qint64 QDeadlineTimer::deadlineNSecs() const

QElapsedTimer::msecsSinceReference() と同じ、基準クロックからの相対ナノ秒単位で計算された、QDeadlineTimer オブジェクトに格納されている期限の絶対時点を返します。このQDeadlineTimer が期限切れの場合、値は過去になります。

このQDeadlineTimer が期限切れでない場合、または期限までのナノ秒数を戻り値の型に含めることができない場合、この関数はstd::numeric_limits<qint64>::max() を返す。

この関数は、以下の例のように、QDeadlineTimer::current （）を差し引くことで、タイマーの期限超過時間を計算するために使用することができます：

    qint64 realTimeLeft = deadline.deadlineNSecs();
    if (realTimeLeft != std::numeric_limits<qint64>::max())
        realTimeLeft -= QDeadlineTimer::current().deadlineNSecs();

remainingTime() および deadlineNSecs()も参照 。

[noexcept] bool QDeadlineTimer::hasExpired() const

このQDeadlineTimer オブジェクトが期限切れの場合は true を、残り時間がある場合は false を返します。期限が切れたオブジェクトについては、remainingTime() はゼロを返し、deadline() は過去の時点を返します。

QDeadlineTimer ForeverConstant で作成されたオブジェクトの有効期限はなく、この関数は常に false を返します。

isForever() およびremainingTime()も参照 。

[constexpr noexcept] bool QDeadlineTimer::isForever() const

このQDeadlineTimer オブジェクトが期限切れにならない場合は true を返し、そうでない場合は false を返します。有効期限がないタイマーの場合、remainingTime() は常に -1 を返し、deadline() は最大値を返す。

ForeverConstant 、hasExpired()、remainingTime()も参照 。

[noexcept] qint64 QDeadlineTimer::remainingTime() const

QDeadlineTimer オブジェクトの残り時間をミリ秒単位で返す。タイマーがすでに期限切れになっている場合、この関数は 0 を返し、この関数で期限切れ時間を取得することはできない（取得するにはdeadline() を参照）。タイマーが期限切れにならないように設定されていた場合、この関数は -1 を返します。

この関数は、多くのQIODevice waitFor 関数や、QMutex,QWaitCondition,QSemaphore,QReadWriteLock の時間指定ロック関数など、ミリ秒のタイムアウトを取る Qt API での使用に適しています。例えば

    mutex.tryLock(deadline.remainingTime());

setRemainingTime()、remainingTimeNSecs()、isForever()、hasExpired()も参照のこと 。

[noexcept] std::chrono::nanoseconds QDeadlineTimer::remainingTimeAsDuration() const

期限までの残り時間を返します。

[noexcept] qint64 QDeadlineTimer::remainingTimeNSecs() const

このQDeadlineTimer オブジェクトの残り時間をナノ秒単位で返します。タイマーがすでに期限切れになっている場合、この関数はゼロを返し、この関数で期限超過時間を取得することはできない。タイマーが期限切れにならないように設定されていた場合、この関数は -1 を返す。

remainingTime()、isForever()、hasExpired()も参照 。

[noexcept] void QDeadlineTimer::setDeadline(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

このQDeadlineTimer オブジェクトの期限を、基準クロックからのミリ秒単位でカウントしたmsecs 絶対時点に設定し（QElapsedTimer::msecsSinceReference() と同じ）、タイマー・タイプをtimerType に設定する。値が過去の場合、このQDeadlineTimer は期限切れとしてマークされる。

msecs がstd::numeric_limits<qint64>::max() である場合、または期限が将来の表現可能な時点を超えている場合、 このQDeadlineTimer は期限切れにならないように設定される。

setPreciseDeadline()、deadline()、deadlineNSecs()、setRemainingTime()も参照 。

template <typename Clock, typename Duration = typename Clock::duration> void QDeadlineTimer::setDeadline(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

このQDeadlineTimer を、Clock のクロック・ソースから Qt の内部クロック・ソース (QElapsedTimer::clockType() を参照) に変換して、deadline のタイム・ポイントで示される期限に設定します。

deadline が過去の場合、このQDeadlineTimer オブジェクトは期限切れに設定され、deadline がDuration::max() と等しい場合、このオブジェクトは期限切れにならないように設定されます。

このQDeadlineTimer オブジェクトのタイマー・タイプは、指定されたtype に設定される。

hasExpired （）、isForever （）、remainingTime （）も参照 。

[noexcept] void QDeadlineTimer::setPreciseDeadline(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

このQDeadlineTimer オブジェクトの期限を、基準クロック・エポックからsecs 秒およびnsecs ナノ秒に設定し（QElapsedTimer::msecsSinceReference （）と同じ）、タイマー・タイプをtimerType に設定する。値が過去の場合、このQDeadlineTimer は期限切れとしてマークされる。

secs またはnsecs がstd::numeric_limits<qint64>::max() の場合、このQDeadlineTimer は期限切れにならないように設定される。nsecs が10億ナノ秒（1秒）を超える場合、secs はそれに応じて調整される。

setDeadline()、deadline()、deadlineNSecs()、setRemainingTime()も参照 。

[noexcept] void QDeadlineTimer::setPreciseRemainingTime(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

このQDeadlineTimer オブジェクトの残り時間を、secs が正の値の場合、secs 秒に今からnsecs ナノ秒を加えた値に設定する。secs が負の値の場合、このQDeadlineTimer は期限切れにならないように設定されます（この動作はnsecs には適用されません）。両方のパラメータがゼロの場合、このQDeadlineTimer は期限切れとしてマークされる。

最適化のため、secs とnsecs の両方がゼロの場合、この関数は現在時刻の取得を省略し、代わりに過去の既知の値を使用することがある。その場合、deadline （）は予期しない値を返すことがあり、このオブジェクトを期限切れ時間の計算に使用することはできない。そのような機能が必要な場合は、QDeadlineTimer::current() を使用し、それに時間を追加してください。

このQDeadlineTimer オブジェクトのタイマー・タイプは、指定されたtimerType に設定されます。

setRemainingTime(),hasExpired(),isForever(),remainingTime()も参照してください 。

[noexcept] void QDeadlineTimer::setRemainingTime(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

msecs に正の値がある場合、このQDeadlineTimer オブジェクトの残り時間をmsecs ミリ秒後に設定する。msecs がゼロの場合、このQDeadlineTimer オブジェクトは期限切れとしてマークされ、負の値の場合は期限切れにならないように設定されます。

最適化のため、msecs がゼロの場合、この関数は現在時刻の取得を省略し、代わりに過去の既知の値を使用することがある。その場合、deadline （）は予期しない値を返すことがあり、このオブジェクトを期限切れ時間の計算に使用することはできない。そのような機能が必要な場合は、QDeadlineTimer::current() を使用し、それに時間を追加してください。

このQDeadlineTimer オブジェクトのタイマー・タイプは、指定されたtimerType に設定されます。

setPreciseRemainingTime(),hasExpired(),isForever(),remainingTime()も参照してください 。

template <typename Rep, typename Period> void QDeadlineTimer::setRemainingTime(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

これはオーバーロードされた関数です。

このQDeadlineTimer オブジェクトの残り時間をremaining に設定します。remaining が 0 または負の場合、このQDeadlineTimer オブジェクトは期限切れとしてマークされ、remaining がduration::max() と等しい場合、このオブジェクトは期限切れにならないように設定されます。

このQDeadlineTimer オブジェクトのタイマー・タイプは、指定されたtype に設定されます。

この関数は、in などの C++14 の時間に関するユーザー定義リテラルとともに使用できます：

    using namespace std::chrono_literals;
    deadline.setRemainingTime(250ms);

setDeadline()、remainingTime()、hasExpired()、isForever()も参照して ください。

void QDeadlineTimer::setTimerType(Qt::TimerType timerType)

このオブジェクトのタイマー型をtimerType に変更します。

timerType Qt::PreciseTimer は Qt が見つけることができる最も正確なタイマーを使用します。分解能は 1 ミリ秒以上で、 はより粗いタイマーを使用しようとします。 と はより粗いタイマーを使用しようとします。QDeadlineTimer Qt::CoarseTimer Qt::VeryCoarseTimer

timerType() とQt::TimerTypeも参照して ください。

[noexcept] void QDeadlineTimer::swap(QDeadlineTimer &other)

このデッドライン・タイマーをother のデッドライン・タイマーと交換する。

[noexcept] Qt::TimerType QDeadlineTimer::timerType() const

このオブジェクトで有効なタイマー・タイプを返します。

setTimerType()も参照 。

QDeadlineTimer &QDeadlineTimer::operator+=(qint64 msecs)

このQDeadlineTimer オブジェクトをmsecs ミリ秒延長し、それ自身を返す。このオブジェクトが期限切れにならないように設定されている場合、この関数は何もしません。

1ミリ秒を超える精度の時間を追加するには、addNSecs() を使用する。

QDeadlineTimer &QDeadlineTimer::operator-=(qint64 msecs)

このQDeadlineTimer オブジェクトをmsecs ミリ秒短縮し、それ自身を返す。このオブジェクトがnever expireに設定されている場合、この関数は何もしない。

1ミリ秒より大きい精度の時間を減算するには、addNSecs （）を使用する。

template <typename Rep, typename Period> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::duration<Rep, Period> remaining)

このデッドライン・タイマーをremaining の時刻に設定します。

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::time_point<Clock, Duration> deadline_)

このデッドライン・タイマーにdeadline_ を割り当てます。