C++ 轻量级命令行解析库 cmdline

0x0 前言

  • 平时用 C++ 写一些命令行工具,须要解析命令行的输入參数,这是一项繁琐而且 easy 出错的工作,我们不应该将主要精力放在这上面。
  • 考虑使用开源的库。以下的 cmdline 就是当中很好用的一款。

0x1 cmdline 介绍

  • cmdline 是一个非常 easy 好用的 C++ 命令行解析库,其基于模板。所以使用非常 easy,写出的代码也非常优雅。
  • 因为其仅仅包括一个头文件。所以非常 easy 集成到自己的项目中。
  • cmdline 项目托管地址 Github:https://github.com/tanakh/cmdline

0x2 cmdline 修正

  • 若使用 VisualStudio 系列 IDE 编译会报错,因此需要修正部分代码
  1. 修改 #include 部分
//当编译器非gcc时,不包含cxxabi.h头文件
#ifdef __GNUC__
#include <cxxabi.h>
#endif
  1. 修改 demangle 函数,当编译器为 MSVC 时直接将输入参数返回
static inline std::string demangle(const std::string& name)
{
    #ifdef _MSC_VER
    return name;
    #elif	defined(__GNUC__)
    int status = 0;
    char* p = abi::__cxa_demangle(name.c_str(), 0, 0, &status);
    std::string ret(p);
    free(p);
    return ret;
    #endif // _MSC_VER
}

0x3 cmdline 使用

00 中文示例

  • 以下是 cmdline 项目首页给出的演示样例代码,我将当中的注释翻译成了中文,同一时候加入了一些自己使用经验和理解。
#include <iostream>
using namespace std;
#include "cmdline.h"

int main(int argc, char *argv[])
{
    // 创建一个命令行解析器
    cmdline::parser a;
    // 加入指定类型的输入參数
    // 第一个參数:长名称
    // 第二个參数:短名称(‘\0‘表示没有短名称)
    // 第三个參数:參数描写叙述
    // 第四个參数:bool值,表示该參数是否必须存在(可选。默认值是false)
    // 第五个參数:參数的默认值(可选,当第四个參数为false时该參数有效)
    a.add<string>("host", 'h', "host name", true, "");
    // 第六个參数用来对參数加入额外的限制
    // 这里端口号被限制为必须是1到65535区间的值,通过cmdline::range(1, 65535)进行限制 
    a.add<int>("port", 'p', "port number", false, 80, cmdline::range(1, 65535));
    // cmdline::oneof() 能够用来限制參数的可选值
    a.add<string>("type", 't', "protocol type", false, "http", cmdline::oneof<string>("http", "https", "ssh", "ftp"));
    // 也能够定义bool值
    // 通过调用不带类型的add方法
    a.add("flag", 'f', "flag when transfer");
    // 执行解析器
    // 仅仅有当全部的參数都有效时他才会返回
    //  假设有无效參数,解析器会输出错误消息。然后退出程序
    // 假设有‘--help‘或-?‘这种帮助标识被指定,解析器输出帮助信息。然后退出程序

    a.parse_check(argc, argv);
    // 获取输入的參数值
    cout << a.get<string>("type") << "://"
         << a.get<string>("host") << ":"
         << a.get<int>("port") << endl;
    // bool值能够通过调用exsit()方法来推断
    if (a.exist("flag")) cout << "flag" << endl;
}

01 使用测试

  • 仅仅输入程序名,默认会输出帮助信息。选项后面的括号里显示了其类型和默认值(中括号)
$ ./test
usage: ./test --host=string [options] ...
options:
  -h, --host    host name (string)
  -p, --port    port number (int [=80])
  -t, --type    protocol type (string [=http])
  -f  --flag    flag when transfer
  -?, --help    print this message
  • 通过以下方式显示的输出帮助信息
$ ./test -?
usage: ./test --host=string [options] ...
options:
  -h, --host    host name (string)
  -p, --port    port number (int [=80])
  -t, --type    protocol type (string [=http])
  -f  --flag    flag when transfer
  -?, --help    print this message
  • 输入必选字段–主机名,其它參数是可选的。
  • 当缺省时使用默认值,这里使用了默认协议 http 和默认 port 号 80
$ ./test --host=github.com
http://github.com:80
  • 输入-t 參数。使用 ftp 覆盖默认值 http
$ ./test --host=github.com -t ftp
ftp://github.com:80
  • 因为-t 參数限制为仅仅能取 cmdline::oneof<string>(“http”, “https”, “ssh”, “ftp”)中的某一个。这里输入的-t ttp 不在当中,因此被视为无效參数。程序输入帮助信息然后退出。
$ ./test --host=github.com -t ttp
option value is invalid: --type=ttp
usage: ./test --host=string [options] ...
options:
  -h, --host    host name (string)
  -p, --port    port number (int [=80])
  -t, --type    protocol type (string [=http])
  -f  --flag    flag when transfer
  -?, --help    print this message
  • 使用 bool 型參数
$ ./test --host=github.com --flag
http://github.com:80
flag

02 其它选项

  • footer 脚注

footer() 方法用来在帮助信息后面加入自己定义文本,比如:

a.footer("user define information...");

执行结果:

$ ./test
usage: ./test --host=string [options] ... user define information...
options:
  -h, --host    host name (string)
  -p, --port    port number (int [=80])
  -t, --type    protocol type (string [=http])
      --gzip    gzip when transfer
  -?, --help    print this message
  • pragram name 应用程序名

通过 argv[0].set_program_name()能够设置帮助信息中的应用程序显示的名称

a.set_program_name("test");
  • 手动打印帮助信息
cout << a.usage() << endl;

0x4 参考

© 版权声明
THE END
喜欢就支持一下吧
点赞10 分享
评论 共1条
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情

    Warning: file_get_contents(https://api.oioweb.cn/api/ip/ipaddress?ip=124.90.109.175): failed to open stream: Connection refused in /www/wwwroot/xiasec/wp-content/plugins/ACG/inc/options/functions.php on line 382