QChronoTimer Class

詳細説明

QChronoTimerクラスはタイマーのハイレベルプログラミングインタフェースを提供します。使用するには、コンストラクタにインターバルを渡すか、コンストラクタの後にsetInterval() を使用してインターバルを設定し、timeout() シグナルを適切なスロットに接続し、start() を呼び出します。それ以降、一定の間隔でtimeout() シグナルが発せられます。例えば

        QChronoTimer *timer = new QChronoTimer(1s, this);
        connect(timer, &QChronoTimer::timeout, this, &MyWidget::processOneThing);
        timer->start();
        QChronoTimer *timer = new QChronoTimer(this);
        connect(timer, &QChronoTimer::timeout, this, &MyWidget::processOneThing);
        timer->setInterval(1s);
        timer->start();

setSingleShot(true)を呼び出すことで、タイマーを一度だけタイムアウトするように設定できます。

マルチスレッド・アプリケーションでは、イベント・ループを持つどのスレッドでもQChronoTimerを使うことができます。非GUIスレッドからイベントループを開始するには、QThread::exec （）を使用します。Qtはタイマーのthread affinity 、どのスレッドがtimeout()シグナルを発信するかを決定します。このため、そのスレッドでタイマーを開始および停止する必要があります。他のスレッドからタイマーを開始することはできません。

他のスレッドからタイマーを開始することはできません。特別なケースとして、タイムアウトが0ns のQChronoTimerは、できるだけ早くタイムアウトします。ただし、ゼロタイマーと他のイベント・ソースとの順序は指定されていません。ゼロタイマーは、応答性の良いユーザーインターフェイスを提供しながら、いくつかの作業を行うために使用することができます：

        // The default interval is 0ns
        QChronoTimer *timer = new QChronoTimer(this);
        connect(timer, &QChronoTimer::timeout, this, &MyWidget::processOneThing);
        timer->start();

それ以降、processOneThing() が繰り返し呼び出される。それ以降、 は繰り返し呼び出されます。Qt がユーザーインターフェースにイベントを配信し、すべての処理を終えるとすぐにタイマーを停止できるように、タイマーは常に素早く（例えば、1 つのデータアイテムを処理した後に）戻るように記述する必要があります。これはGUIアプリケーションで重い処理を実装する伝統的な方法ですが、マルチスレッドがより多くのプラットフォームで利用できるようになってきているため、GUI（メイン）スレッド以外のスレッドで重い処理を行うのが現代的な代替方法です。QtにはQThread というクラスがあり、これを使うことで実現できます。

精度とタイマーの分解能

タイマーの精度は、基盤となるオペレーティング・システムとハードウェアに依存します。ほとんどのプラットフォームは、タイマーにナノ秒の精度を要求することをサポートしています（例えば、libcのnanosleep ）が、タイマーの精度は多くの実世界の状況ではこの分解能に等しくありません。

QChronoTimerにどの精度をシステムから要求するかを伝えるために、timer type を設定することができます。

Qt::PreciseTimer の場合、QChronoTimer は精度を1ns に保とうとします。高精度タイマーは予想より早くタイムアウトすることはありません。

Qt::CoarseTimer とQt::VeryCoarseTimer タイプの場合、QChronoTimer はこれらのタイプのマージンの範囲内で、予想より早く目覚める可能性があります：

• の間隔の5%です。Qt::CoarseTimer
• 500ms に対してQt::VeryCoarseTimer

システムがビジー状態であったり、要求された精度を提供できない場合、すべてのタイマー・タイプは予想より遅れてタイムアウトする可能性がある。このようなタイムアウト・オーバーランの場合、Qt はtimeout() を一度だけ、たとえ複数のタイムアウトがあったとしても出します。

QChronoTimerの代替

QChronoTimerはナノ秒の分解能と±292年の範囲を提供します（間隔がstd::numeric_limits<int>::max() より長い場合、整数オーバーフローの可能性が低くなります）。ミリ秒の分解能と±24日の範囲しか必要ない場合は、従来のQTimer 。

別の方法としては、QObject::timerEvent() メソッドをあなたのクラス（QObject のサブクラスでなければなりません）に再実装し、以下のアプローチのいずれかを使用する方法があります：

• タイマー ID をラップする軽量値クラス、QBasicTimer を使用する。QBasicTimer::start() でタイマーを開始し、QBasicTimer::stop() でタイマーを停止します。イベントを処理するには、timerEvent() を使用します。
• より低レベルな方法は、タイマーIDを直接操作することです。タイマーを開始するには、QObject::startTimer （）を呼び、返されたIDを保存する。タイマーを停止するには、QObject::killTimer （）を呼び出す。再実装したtimerEvent （）でイベントを処理できる。この方法は通常、QBasicTimer を使用するよりも面倒である。

timerEvent() を使用することの欠点は、シングル・ショット・タイマーやシグナ ルなどの高レベルの機能がサポートされていないことである。

オペレーティングシステムによっては、使用できるタイマーの数が制限されています。