linux的命令行解析参数之getopt_long函数

函数原型:

#include <getopt.h>
int getopt(int argc, char * const argv[],const char *optstring);  
int getopt_long(int argc, char * const argv[], const char *optstring, const struct option *longopts, int *longindex);  
int getopt_long_only(int argc, char * const argv[], const char *optstring, const struct option *longopts, int *longindex);

参数以及返回值介绍（以上三个函数都适用）：

1、argc和argv和main函数的两个参数一致。

2、optstring: 表示短选项字符串。

    形式如“a:b::cd:“，分别表示程序支持的命令行短选项有-a、-b、-c、-d，冒号含义如下：
    (1)只有一个字符，不带冒号——只表示选项， 如-c 
    (2)一个字符，后接一个冒号——表示选项后面带一个参数，如-a 100
    (3)一个字符，后接两个冒号——表示选项后面带一个可选参数，即参数可有可无，如果带参数，则选项与参数直接不能有空格
        形式应该如-b200

longopts：表示长选项结构体。结构如下：

struct option 
{  
     const char *name;  
     int         has_arg;  
     int        *flag;  
     int         val;  
};  

例子:
static struct option long_options[] =
{
    {"bag", required_argument, NULL, 'b'},
    {"topic", required_argument, NULL, 't'},
    {"help", no_argument, NULL, 'h'},
    { 0, 0, 0, 0 }
};

(1)name:表示选项的名称,比如daemon,dir,out等。

  (2)has_arg:表示选项后面是否携带参数。该参数有三个不同值，如下：

           a: no_argument(或者是0)时 ——参数后面不跟参数值，eg: --version,--help
           b: required_argument(或者是1)时 ——参数输入格式为：--参数 值 或者 --参数=值。eg:--dir=/home
           c: optional_argument(或者是2)时  ——参数输入格式只能为：--参数=值
  (3)flag:这个参数有两个意思，空或者非空。

           a:如果参数为空NULL，那么当选中某个长选项的时候，getopt_long将返回val值。
                   eg，可执行程序 --help，getopt_long的返回值为h.             
           b:如果参数不为空，那么当选中某个长选项的时候，getopt_long将返回0，并且将flag指针参数指向val值。

                   eg: 可执行程序 --http-proxy=127.0.0.1:80 那么getopt_long返回值为0，并且lopt值为1。

  (4)val：表示指定函数找到该选项时的返回值，或者当flag非空时指定flag指向的数据的值val。

全局变量：

（1）optarg：表示当前选项对应的参数值。
（2）optind：表示的是下一个将被处理到的参数在argv中的下标值。
（3）opterr：如果opterr = 0，在getopt、getopt_long、getopt_long_only遇到错误将不会输出错误信息到标准输出流。opterr在非0时，向屏幕输出错误。
（4）optopt：表示没有被未标识的选项。

完整例子(包含一个选项多个参数的实现):

void parseArgs(int argc, char **argv)
{
    int opt;
    int option_index = 0;
    const char *optstring = "b:t:h";

    int pos1;
    std::string name_tmp;

    int index;
    int topic_counter = 0;
    char *next = NULL;
    std::string topic_name_in, topic_name_out;

    //param process
    while((opt = getopt_long(argc, argv, optstring, long_options, &option_index))!= -1)
    {
        switch(opt) {
        case 'b':
            std::cout << "hit bag" << std::endl;
            std::cout << "b: " << optarg << std::endl;
            std::cout << "option_index: " << option_index << std::endl;
            std::cout << "long_options[option_index].name: " << long_options[option_index].name << std::endl;
            std::cout << "argv[" << optind - 1 << "] = " << argv[optind - 1] << std::endl;

            bag_name = argv[optind - 1];
            break;
        case 't':
            std::cout << "hit topic" << std::endl;
            std::cout << "t: " << optarg << std::endl;
            std::cout << "option_index: " << option_index << std::endl;
            std::cout << "long_options[option_index].name: " << long_options[option_index].name << std::endl;

            index = optind - 1;
            while (index < argc) {
                next = strdup(argv[index]);
                topic_name_in = next;
                pos1 = topic_name_in.rfind('/');
                name_tmp = topic_name_in.substr(0, pos1);
                topic_name_out = name_tmp + "/image_raw";
                index++;
                topic_counter++;
                switch (topic_counter) {
                case 1:
                    cam1_topic_name = topic_name_in;
                    cam1_topic_name_save = topic_name_out;
                    std::cout << "cam1_topic_name: " << cam1_topic_name << std::endl;
                    std::cout << "cam1_topic_name_save: " << cam1_topic_name_save << std::endl;
                    break;
                case 2:
                    cam2_topic_name = topic_name_in;
                    cam2_topic_name_save = topic_name_out;
                    std::cout << "cam2_topic_name: " << cam2_topic_name << std::endl;
                    std::cout << "cam2_topic_name_save: " << cam2_topic_name_save << std::endl;
                    break;
                case 3:
                    cam1_topic_name = topic_name_in;
                    cam1_topic_name_save = topic_name_out;
                    std::cout << "cam3_topic_name: " << cam3_topic_name << std::endl;
                    std::cout << "cam3_topic_name_save: " << cam3_topic_name_save << std::endl;
                    break;
                case 4:
                    cam4_topic_name = topic_name_in;
                    cam4_topic_name_save = topic_name_out;
                    std::cout << "cam4_topic_name: " << cam4_topic_name << std::endl;
                    std::cout << "cam4_topic_name_save: " << cam4_topic_name_save << std::endl;
                    break;
                }

                if (next[0] == '-') {   /* check if optarg is next switch */
                    break;
                }
            }

            std::cout << "argv[" << optind - 1 << "] = " << argv[optind - 1] << std::endl;
            exit(0);
            break;
        case 'h':
            std::cout << "hit help" << std::endl;
            std::cout << usage << std::endl;
            exit(0);
            break;
        case '?':
            std::cout << "unknown option" << std::endl;
            // printf("optopt: %c\n", optopt);
            // printf("opterr: %d\n", opterr);
            std::cout << usage << std::endl;
            exit(0);
            break;
        default:
            std::cout << "default" << std::endl;
            std::cout << usage << std::endl;
            exit(0);
        }
    }

    //do param check
    if (cam1_topic_name == "null" || bag_name == "null" || cam1_topic_name_save == "null") {
                std::cout << usage << std::endl;
        exit(0);
    }

    // if (opt == -1) {
    //     std::cout << "opt: " << opt << std::endl;
    //     std::cout << usage << std::endl;
    //     return -1;
    // }
}