「Qtの設定 - コマンドライン引数」の版間の差分

Qtの設定 - コマンドライン引数 (ソースを閲覧)

2024年8月28日 (水) 18:18時点における版

1,218 バイト追加、 2024年8月28日 (水)

→‎QCommandLineParserクラスとQCommandLineOptionを使用する方法

Wiki

ビューロクラット、インターフェース管理者、管理者

12,925

回編集

@@ 7行目: / 7行目: @@
 <br><br>
-== QCommandLineParserクラスとQCommandLineOptionを使用する方法 ==
+== QCommandLineParserクラスの使用 ==
-以下のサンプルコードでは、<code>sl</code>コマンドのオプションに倣って、<code>-a</code>、<code>-l</code>、<code>-F</code>、<code>-h/–help</code>を解析している。<br>
+以下の例では、<code>QCommandLineParser</code>クラスを使用して、指定されたオプションを処理している。<br>
+<br>
+* QCommandLineParserクラスを使用してコマンドラインオプションを定義する。
+* -hオプション、--helpオプション、-vオプション、--versionオプションは、その後に続く値が不要なため、Qtにより自動的に処理される。
+* -cオプション、--configオプションを追加で定義して、値を受け取るように指定する。
+* 上記に存在しないオプションが指定された場合、それらを表示する。
+<br>
   <syntaxhighlight lang="c++">
-  #include <QtCore/QCoreApplication>
+  #include <QCoreApplication>
-  #include <QtCore/QCommandLineParser>
+  #include <QCommandLineParser>
-  #include <QtCore/QDebug>
+  #include <QCommandLineOption>
+ #include <QDebug>
   int main(int argc, char *argv[])
   {
-     QCoreApplication app(argc, argv);
+     QCoreApplication a(argc, argv);
-     app.setApplicationName(QStringLiteral("sl - correct miss typing"));
+     QCoreApplication::setApplicationName("<任意のアプリケーション名>");
+    QCoreApplication::setApplicationVersion("1.0");
      QCommandLineParser parser;
-     parser.setApplicationDescription(QStringLiteral("sl is a highly developed animation program, which corrects your miss typing."));
+     parser.setApplicationDescription("Command line options example");
-     parser.addHelpOption();
+    // バージョンオプション
+    QCommandLineOption versionOption(QStringList() << "v" << "version", "Displays version information.");
+    parser.addOption(versionOption);
+    // ヘルプオプション
+    QCommandLineOption helpOption(QStringList() << "h" << "help", "Displays help information.");
+     parser.addOption(helpOption);
-     QCommandLineOption accidents(QStringLiteral("a"), QStringLiteral("It seems some accidents have happened. People give sad cries."));
+    // 設定オプション
-     parser.addOption(accidents);
+     QCommandLineOption configOption(QStringList() << "c" << "config", "Display the configuration string.", "config");
+     parser.addOption(configOption);
-    QCommandLineOption smaller(QStringLiteral("l"), QStringLiteral("Becomes smaller."));
+     parser.process(a);
-    parser.addOption(smaller);
-    QCommandLineOption fly(QStringLiteral("F"), QStringLiteral("Flies."));
-     parser.addOption(fly);
-     parser.process(app);
+     if (parser.isSet(helpOption)) {
+       parser.showHelp();
+       return 0;
+    }
-     if (parser.isSet(accidents))
+     if (parser.isSet(versionOption)) {
-    {
+        qDebug() << QCoreApplication::applicationName() << QCoreApplication::applicationVersion();
-        qDebug() << "Help!";
+       return 0;
      }
-     if (parser.isSet(smaller))
+     if (parser.isSet(configOption)) {
-    {
+       QString configString = parser.value(configOption);
-        qDebug() << "smaller";
+        qDebug() << "Configuration: " << configString;
+       return 0;
      }
-     if (parser.isSet(fly))
+    // 不明なオプションの場合
-    {
+    QStringList unknownOptions = parser.unknownOptionNames();
-       qDebug() << "I can fly!";
+     if (!unknownOptions.isEmpty()) {
+       for (const QString &option : unknownOptions) {
+          qDebug() << "不明なオプション: " << option;
+       }
+       return -1;
      }
+    qDebug() << "有効なオプションはありません。使用法については、-h または --help を使用してください。";
      return 0;
   }
@@ 54行目: / 75行目: @@
 <br>
   # 実行
- ./sl
- ./sl -a
- ./sl -l
- ./sl -a -l
- ./sl -al
- ./sl -h
- ./sl -S
- # 結果
- Help!
- smaller
- Help!
- smaller
-  Help!
+  <実行ファイル名> -h または <実行ファイル名> --help
-  smaller
+  ヘルプ情報を表示する
-  Usage: ./sl [options]
+  <実行ファイル名> -v または <実行ファイル名> --version
-  sl is a highly developed animation program, which corrects your miss typing.
+  バージョン情報を表示する
-  Options:
+  <実行ファイル名> -c "<任意の文字列>" または <実行ファイル名> --config "<任意の文字列>"
-   -h, --help  Displays this help.
+  指定された設定文字列を表示する
-   -a          It seems some accidents have happened. People give sad cries.
-   -l          Becomes smaller.
-   -F          Flies.
-  Unknown option 'S'.
+  <実行ファイル名> -x
+ "不明なオプション: x" と表示する
 <br>
-<u>※備考</u><br>
+<u>※注意</u><br>
-様々なケースに対応できるような構造になっている。<br>
+<code>QCommandLineParser</code>クラスは、様々なケースに対応できるような構造になっている。<br>
 詳細は、<code>[https://doc.qt.io/qt-5/qcommandlineparser.html QCommandLineParser]</code>と<code>[https://doc.qt.io/qt-5/qcommandlineoption.html QCommandLineOption]</code>のドキュメントを参照すること。<br>
 また、他の使用方法については、[https://code.qt.io/cgit/qt/qtbase.git/tree/tests/auto/corelib/tools/qcommandlineparser/tst_qcommandlineparser.cpp qtbase/tests/auto/corelib/tools/qcommandlineparser/tst_qcommandlineparser.cpp]のテストケースを参照すること。<br>