1 program options简介
program options是一系列pair<name,value>
组成的选项列表,它允许程序通过命令行或配置文件来读取这些参数选项。
options_description | 选项描述器 | 描述当前的程序定义了哪些选项 |
parse_command_line | 选项分析器 | 解析由命令行输入的参数 |
variables_map | 选项存储器 | 作为容器,存储解析后的选项 |
2 程序应用流程
次序 | 命令 | 说明 |
1 | 构造对象 |
构造option_description对象和variables_map对象 |
2 | add_options( ) | 向option_description对象添加选项 |
3 | parse_command_line( ) | 将命令行输入的参数解析出来 |
4 | store( ) | 将解析出的选项存储至variables_map中 |
5 | notify( ) | 通知variables_map去更新所有的外部变量 |
6 | count( ) | 检测某个选项是否被输入 |
7 | operator[ ] | 取出选项的值 |
在上述方法之前,应当进行命名空间的设置,如官方文档所示为
namespace po = boost::program_options;
3 案例(引自作者morning_color)
//linux系统下,编译选项需加上 -lboost_program_options
#include <iostream>
#include <string>
#include <boost/program_options.hpp>
namespace bpo = boost::program_options;
int main(int argc, char const *argv[])
{
//步骤一: 构造选项描述器和选项存储器
//选项描述器,其参数为该描述器的名字
bpo::options_description opts("all options");
//选项存储器,继承自map容器
bpo::variables_map vm;
//步骤二: 为选项描述器增加选项
//其参数依次为: key, value的类型,该选项的描述
opts.add_options()
("filename", bpo::value<std::string>(), "the file name which want to be found")
("help", "this is a program to find a specified file");
//步骤三: 先对命令行输入的参数做解析,而后将其存入选项存储器
//如果输入了未定义的选项,程序会抛出异常,所以对解析代码要用try-catch块包围
try{
//parse_command_line()对输入的选项做解析
//store()将解析后的结果存入选项存储器
bpo::store(bpo::parse_command_line(argc, argv, opts), vm);
}
catch(...){
std::cout << "输入的参数中存在未定义的选项!\n";
return 0;
}
//步骤四: 参数解析完毕,处理实际信息
//count()检测该选项是否被输入
if(vm.count("help") ){//若参数中有help选项
//options_description对象支持流输出, 会自动打印所有的选项信息
std::cout << opts << std::endl;
}
if(vm.count("filename") ){
//variables_map(选项存储器)是std::map的派生类,可以像关联容器一样使用,
//通过operator[]来取出其中的元素.但其内部的元素类型value_type是boost::any,
//用来存储不确定类型的参数值,必须通过模板成员函数as<type>()做类型转换后,
//才能获取其具体值.
std::cout << "find " << vm["filename"].as<std::string>() << std::endl;
}
if(vm.empty() ){
std::cout << "no options found \n";
}
return 0;
}
输出说明:
//编译后可执行文件假设为clion.sh(此处仅说明在Linux系统下的操作),当输入
./clion.sh -help
//输出为
all options:
–filename arg the file name which want to be found
–help this is a program to find a specified file
//输入命令
./clion.sh –filename=graphgen_test
//输出为
find graphgen_test
声明:
本文部分内容引自https://blog.csdn.net/morning_color/article/details/50241987,作者为:morning_color,在此感谢作者的分享。