Qt：解析命令行（使用QCommandLineOption和QCommandLineParser）

Qt從5.2版開始提供了兩個類QCommandLineOption和QCommandLineParser來解析應用的命令行參數。

 

一、命令行寫法
命令行："-abc"

在QCommandLineParser的解析模式為ParseAsCompactedShortOptions(默認)時會被認為是3個參數，即"-a"、"-b"和"-c"

 

QCommandLineOption op1("a");
QCommandLineOption op2("b");
QCommandLineOption op3("c");

QCommandLineParser parser;
parser.addOption(op1);
parser.addOption(op2);
parser.addOption(op3);
parser.process(a);

qDebug() << parser.isSet(op1);  // true
qDebug() << parser.isSet(op2);  // true
qDebug() << parser.isSet(op3);  // true

 

反之，當解析模式為ParseAsLongOptions時，"-abc"會被認為是1個長命令，即"-abc"

但是由於長命令應該是以"--"開頭，所以下面的代碼會出現異常，提示"未知的選項"

 

 

QCommandLineOption op1("a");
QCommandLineOption op2("b");
QCommandLineOption op3("c");

QCommandLineParser parser;
parser.setSingleDashWordOptionMode(QCommandLineParser::ParseAsLongOptions);
parser.addOption(op1);
parser.addOption(op2);
parser.addOption(op3);
parser.process(a);  // 拋出異常，程序退出：Unknown option 'abc'.

 

Qt推薦使用ParseAsCompactedShortOptions模式，這也是默認的解析模式。而ParseAsLongOptions模式則是為了兼容而存在。

 

二、帶值的命令

命令行參數通常就分為兩種，帶值的和不帶值的。不帶值的就直接注冊一個命令就行了，比如上面的

 

QCommandLineOption op1("a");

 

我們可以把這個"-a"理解為一個bool類型的命令。如果需要帶值，則把值寫在命令后面即可，值和命令之間用等號或空格隔開，字符串可以用雙引號括起來

-a ABC
-a=ABC

繼續看一段代碼，假設命令行為"-a="C:/A B/Demo.exe""

 

int main(int argc, char *argv[])
{
  QApplication a(argc, argv);

  // -a="C:/A B/Demo.exe"
  QCommandLineOption op1("a");
  QCommandLineParser parser;
  parser.addOption(op1);
  parser.process(a); // 異常 Unexpected value after '-a'.
  qDebug() << parser.isSet(op1);
  qDebug() << parser.value(op1);

  MainWindow w;
  w.show();

  return a.exec();
}

由於我們定義的op1並沒有說明其會有參數，而實際的命令行后面跟了個參數，解析器就會報錯。Qt文檔中也表示，解析器不支持可選參數。
如果需要附帶參數，則必須指定一個期望值

 

 

int main(int argc, char *argv[])
{
  QApplication a(argc, argv);

  // -a="C:/A B/Demo.exe"
  QCommandLineOption op1("a");
  op1.setValueName("path"); // 期望值是路徑，設置了ValueName后，解析器會認為此命令帶值
  QCommandLineParser parser;
  parser.addOption(op1);
  parser.process(a);
  qDebug() << parser.value(op1);// "C:/A B/Demo.exe"

  MainWindow w;
  w.show();

  return a.exec();
}

 

設置了ValueName后，解析器就會認為此命令帶值，將會認為下一個等號或空格后的值就是參數
這個ValueName名字隨便取，只是起到一個指導性的作用。你甚至可以將它設置為"abc"

另外，值可以有多個

 

int main(int argc, char *argv[])
{
  QApplication a(argc, argv);

  // -a="C:/A B/Demo.exe" -a "Hello world"
  QCommandLineOption op1("a");
  op1.setValueName("test");
  Q CommandLineParser parser;
  parser.addOption(op1);
  parser.process(a);
  qDebug() << parser.values(op1);// ("C:/A B/Demo.exe", "Hello world")

  MainWindow w;
  w.show();

  return a.exec();
}

還有QCommandLineParser的addHelpOption()、addVersionOption()都是添加顯示命令版本和幫助用的，一般只有命令行程序才會用到吧，就不細說了。
解析可以用parse()方法或process()方法，前者遇到不可解析的命令會返回false但不會拋出異常，后者則會拋出異常。

最后，看一個比較完整的示例

 

// -a --BBB -c -D=Jack --Age -m=Hello -m "World"
int main(int argc, char *argv[])
{
  QApplication a(argc, argv);

  QCommandLineOption op1("a");// 短名稱，無參數
  QCommandLineOption op2("BBB");// 長名稱，無參數
  QCommandLineOption op3(QStringList() << "c" << "CCC");// 多個名稱，無參數
  QCommandLineOption op4("D", "", "Name");// 短名稱，有參數，無默認值
  QCommandLineOption op5("Age", "", "", "18");// 長名稱，有參數，有默認值
  QCommandLineOption op6("m", "", "."); // 短名稱，有參數，無默認值

  QCommandLineParser parser;
  parser.addOption(op1);
  parser.addOption(op2);
  parser.addOption(op3);
  parser.addOption(op4);
  parser.addOption(op5);
  parser.addOption(op6);
  parser.process(a);

  qDebug() << parser.isSet(op1); // true
  qDebug() << parser.isSet("BBB"); // true
  qDebug() << parser.isSet("CCC"); // true
  qDebug() << parser.value(op4); // "Jack"
  qDebug() << parser.value(op5); // "18"
  qDebug() << parser.values(op6);// ("Hello", "World")

  qDebug() << parser.helpText();
  MainWindow w;
  w.show();

  return a.exec();
}

 

http://blog.csdn.net/aqtata/article/details/30485963