Qtの基礎 - CUIソフトウェア

概要

Qtは、GUIソフトウェアを開発するために使用されているが、CUIソフトウェアも開発できる。
ただし、CUIは[閉じる]ボタンのように終了する機能が無いため、ソフトウェアから適当なタイミングで閉じるようにしなければならない。

ここでは、Qtにおける基本的なCUIソフトウェアの開発手順を記載する。

CUIソフトウェアの開発手順

例えば、以下に示すようなコンソールアプリケーションがあるとする。

このコンソールアプリケーションは、QCoreApplicationクラスのexecメソッドによりアプリケーションは待機状態となり、
exitメソッドを呼ぶまで待機を続ける。

 int main(int argc, char * argv[])
 {
    QCoreApplication a(argc, argv);
 
    int count = 1000;
    while(--count) {
       printf("Count = %d\n", count);
    }
 
    return a.exec();
 }

この待機状態が不要の場合は、アプリケーションを終了する時に任意の地点でexitメソッドを呼ぶランナークラスを作成すればよい。

例えば、以下に示すようなRunnerクラスを定義する。
そして、Runnerクラスのrunスロット内にアプリケーションのメイン処理を記述して、処理を終了する時にQCoreApplicationクラスのexitメソッドを呼び出す。

 // Runner.h
 
 #ifndef RUNNER_H
 #define RUNNER_H
 
 #include <QObject>
 
 class Runner : public QObject
 {
    Q_OBJECT
 
 public slots:
    void run();  // runスロットメソッドにアプリケーションのメイン処理を記述する
 };
 
 #endif // RUNNER_H

 // Runner.cppファイル
 
 #include <QCoreApplication>
 #include <Runner.h>
 
 void Runner::run()
 {
    // アプリケーションのメイン処理
 
    // ...略
 
    QCoreApplication::exit(0);  // アプリケーションを終了する
 }

重要なことは、QTimerクラスのsingleShotメソッドのタイムアウト時間を0に設定することである。
これは、アプリケーションの全てのイベント (描画処理等) が処理された後に、runメソッドで定義した処理が実行される。

 #include <QCoreApplication>
 #include <QTimer>
 #include "Runner.h"
 
 int main(int argc, char *argv[])
 {
    QCoreApplication a(argc, argv);
 
    // ランナー開始
    Runner runner;
    QTimer::singleShot(0, &runner, SLOT(run()));
 
    return a.exec();
 }

注釈

Qt Creatorでコンソールアプリケーションのプロジェクトを新規作成する場合、main関数内において、以下に示すような注釈が記載されている。

 // A not very useful example would be including
 // #include <QTimer>
 // near the top of the file and calling
 // QTimer::singleShot(5000, &a, &QCoreApplication::quit);
 // which quits the application after 5 seconds.
 
 // If you do not need a running Qt event loop, remove the call
 // to a.exec() or use the Non-Qt Plain C++ Application template.

• "A not very useful example" (あまり有用ではない例)

  注釈の例は、Qtのイベントループの基本的な使用方法を示している。

  注釈の例は、単にコンソールアプリケーションを起動して5秒後に終了させるだけなので、実用的なアプリケーションとしては意味がない。

 // 例として挙げられているコード
 // アプリケーションを5秒後に終了させるタイマを設定する
 
 #include <QTimer>
 QTimer::singleShot(5000, &a, &QCoreApplication::quit);

• 注釈の主旨

  もし、Qtのイベントループを実行する必要がない場合 (Qtの非同期機能やシグナル / スロットを使用しない場合)、

  a.execメソッドの呼び出しを削除する、あるいは、「Non-Qt Plain C++ Application」テンプレートを使用することを提案している。

• 注釈の意図
  • 開発者に、プロジェクトの要件を考慮してもらうこと。
  • Qtの機能 (イベントループ等) が本当に必要かどうかを検討してもらうこと。
  • 不必要にQtの機能を使用することにより、アプリケーションが複雑化、または、パフォーマンスに悪影響が出ることを避けること。

• 開発者への指針

  もし、Qtの高度な機能 (シグナル / スロット、非同期処理等) を使用する予定がある場合は、a.execメソッドを保持してイベントループを実行する。

  単純なコンソールアプリケーションで、Qtの特別な機能が不要な場合は、a.execメソッドを削除する、または、純粋なC++アプリケーションとして開発することを検討する。

この注釈は、開発者がプロジェクトの要件を適切に理解して、必要に応じてQtの機能を使用する、あるいは、より単純な構造を選択するかを判断する助けとなる。