[C++Boost]程序参数项解析库Program_options使用指南.docVIP

［C++Boost］程序参数项解析库Program_options使用指南 介绍 程序参数项(program options)是一系列name=value对，program_options 允许程序开发者获得通过命令行(command line)和配置文件(config file)获取这些参数项。 为什么需要这样一个库？为什么比你手工写代码分解命令行参数要好？ 使用更容易。定义参数处理的语法简单，库自身很小。像转换参数值到指定的类型和保存参数值到变量的事情都是自动处理。 错误报告更友好。可报告错误的命令行参数。另外这个库能自动生成使用帮助，避免手工更新使用帮助导致的不一致。 参数能从不同地方读取。当命令行参数不能满足要求，需要改用配置文件或环境变量。这些功能都能支持，代码改动很小。 使用指南 快速入门 使用详解 参数多种来源 在本节，我们从最简单的例子开始，学习program_options库的通常用法。下面的例子仅仅是代码片断，完整例子在“BOOST_ROOT/libs/program_options/example”目录里。对所有例子，假定都在如下名字空间中： namespace po = boost::program_options; 快速入门 第一个例子尽可能简单：仅仅包含两个参数项。代码如下（完整代码见“example/first.cpp”）： // Declare the supported options. po::options_description desc(Allowed options); desc.add_options() (help, produce help message) (compression, po::value(), set compression level) ; po::variables_map vm; po::store(po::parse_command_line(ac, av, desc), vm); po::notify(vm); if (vm.count(help)) { cout desc \n; return 1; } if (vm.count(compression)) { cout Compression level was set to vm[compression].as() .\n; } else { cout Compression level was not set.\n; } 首先用类 options_description 描述所有允许的参数项，类的add_options方法返回定义了operator()的代理对象，调用其operator()用来实际描述参数项，函数参数是参数项名称，相关值信息，参数项描述。本例中，第一个参数项没有值，第二个参数项有一个int类型的值。 其后，定义一个类 variables_map 对象。用来存储参数项的值，其能存储任意类型的值。接着调用store, parse_command_line 和 notify函数，解析命令行参数并保存到vm中。 现在，可以像使用std::map一样来使用variables_map类，但存储的值必须能通过 at 方法找回。假如调用as方法指定的类型和实际类型不符，将抛出异常） 现在自己可以尝试编译一下代码，如何编译的例子如下： $bin/gcc/debug/first Compression level was not set. $bin/gcc/debug/first --help Allowed options: --help : produce help message --compression arg : set compression level $bin/gcc/debug/first --compression 10 Compression level was set to 10. 使用详解 参数项的值，除了int还有其他类型，还有其他属性，我们下面将讨论。完整例子在“example/options_description.cpp”中。 假如我们写一个编译器程序。它有最优化级别, 包含多个路径, 多个输入文件等参数。描述参数项如下：　 int opt; po::options_description desc(Allowed options); desc.add_options() (help, produce help message) (optimization, po::value(opt)-de