介紹
命令行接口是普遍,基礎(chǔ)的人機(jī)交互接口,從命令行提取程序的運(yùn)行時(shí)選項(xiàng)的方法有很多。你可以自己編寫相對應(yīng)的完整的解析函數(shù),或許你有豐富的C語言編程經(jīng)驗(yàn),熟知getopt()函數(shù)的用法,又或許使用Python的你已經(jīng)在使用optparse庫來簡化這一工作。大家在平時(shí)不斷地談及到“不要重復(fù)造輪子”,那就需要掌握一些順手的庫,這里介紹一種C++方式來解析命令行選項(xiàng)的方法,就是使用Boost.Program_options庫。
program_options提供程序員一種方便的命令行和配置文件進(jìn)行程序選項(xiàng)設(shè)置的方法。使用program_options庫而不是你自己動手寫相關(guān)的解析代碼,因?yàn)樗唵危暶鞒绦蜻x項(xiàng)的語法簡潔,并且?guī)熳陨硪卜浅P ⑦x項(xiàng)值轉(zhuǎn)換為適合的類型值的工作也都能自動完成。庫有著完備的錯誤檢查機(jī)制,如果自己手寫解析代碼時(shí),就可能會錯過對一些出錯情況的檢查了。最后,選項(xiàng)值不僅能從命令行獲取,也能從配置文件,甚至于環(huán)境變量中提取,而這些選擇不會增加明顯的工作量。
示例說明
以下面簡單的hello程序進(jìn)行說明,默認(rèn)打印hello world,如果傳入-p選項(xiàng),就會打印出人的姓名,另外通過傳入-h選項(xiàng),可以打印出幫助選項(xiàng)。略微看一眼代碼文件和相應(yīng)的屏幕輸入輸出,然后我們再一起來看看這些是如何發(fā)生的。
//hello.cpp
#include <iostream>
#include <string>
#include <boost/program_options.hpp>
using namespace std;
int main(int argc, char* argv[])
{
using namespace boost::program_options;
//聲明需要的選項(xiàng)
options_description desc("Allowed options");
desc.add_options()
("help,h", "produce help message")
("person,p", value<string>()->default_value("world"), "who")
;
variables_map vm;
store(parse_command_line(argc, argv, desc), vm);
notify(vm);
if (vm.count("help")) {
cout << desc;
return 0;
}
cout << "Hello " << vm["person"].as<string>() << endl;
return 0;
}
下面是在Windows命令提示符窗口上的輸入輸出結(jié)果,其中">"表示提示符。
>hello
Hello world
>hello -h
Allowed options:
-h [ --help ] produce help message
-p [ --person ] arg (=world) who
>hello --person len
Hello len
首先通過options_description類聲明了需要的選項(xiàng),add_options返回了定義了operator()的特殊的代理對象。這個調(diào)用看起來有點(diǎn)奇怪,其參數(shù)依次為選項(xiàng)名,選項(xiàng)值,以及選項(xiàng)的描述。注意到示例中的選項(xiàng)名為"help,h",是因?yàn)槁暶髁司哂卸踢x項(xiàng)名和長選項(xiàng)名的選項(xiàng),這跟gnu程序的命令行具有一致性。當(dāng)然你可以省略短選項(xiàng)名,但是這樣就不能用命令選項(xiàng)簡寫了。第二個選項(xiàng)的聲明,定義了選項(xiàng)值為string類型,其默認(rèn)值為world.
接下來,聲明了variables_map類的對象,它主要用來存儲選項(xiàng)值,并且能儲存任意類型的值。然后,store,parse_command_line和notify函數(shù)使vm能存儲在命令行中發(fā)現(xiàn)的選項(xiàng)。
最后我們就自由地使用這些選項(xiàng)了,variables_map類的使用就像使用std::map一樣,除了它必須用as方法去獲取值。如果as方法調(diào)用的指定類型與實(shí)際存儲的類型不同,就會有異常拋出。
具有編程的你可能有這樣的經(jīng)驗(yàn),使用cl或gcc對源文件進(jìn)行編譯時(shí),可直接將源文件名放置在命令行中,而無需什么選項(xiàng)字母,如gcc a.c之類的。prgram_options也能處理這種情況,在庫中被稱為"positional options"(位置選項(xiàng)),但這需要程序員的一點(diǎn)兒幫助才能完成。看下面的經(jīng)過對應(yīng)修改的代碼,我們無需傳入"-p"選項(xiàng),就能可指定"person"選項(xiàng)值
positional_options_description p;
p.add("person", -1);
store(command_line_parser(argc, argv).options(desc).positional(p).run(), vm);
>hello len
Hello len
前面新增的兩行是為了說明所有的位置選項(xiàng)都應(yīng)被解釋成"person"選項(xiàng),這里還采用了command_line_parser類來解析命令行,而不是用parse_command_line函數(shù)。后者只是對前者類的簡單封裝,但是現(xiàn)在我們需要傳入一些額外的信息,所以要使用類本身。
選項(xiàng)復(fù)合來源
一般來說,在命令行上指定所有選項(xiàng),對用戶來說是非常煩人的。如果有些選項(xiàng)要應(yīng)用于每次運(yùn)行,那該怎么辦呢。我們當(dāng)然希望能創(chuàng)建出帶有些常用設(shè)置的選項(xiàng)文件,跟命令行一起應(yīng)用于程序中。當(dāng)然這一切需要將命令行與配置文件中的值結(jié)合起來。比如,在命令行中指定的某些選項(xiàng)值應(yīng)該能覆蓋配置文件中的對應(yīng)值,或者將這些值組合起來。
下面的代碼段將選項(xiàng)通過文件讀取,這文件是文本格式,可用"#"表示注釋,格式如命令行中的參數(shù)一樣,選項(xiàng)=值
ifstream ifs("config.cfg");
store(parse_config_file(ifs,config),vm);
notify(vm);
參考
Boost.prgram_options庫文檔
posted on 2008-06-15 21:03
len 閱讀(13625)
評論(0) 編輯 收藏 引用 所屬分類:
程序開發(fā)