函数getopt_long_only()

第一次接触这个函数,是因为学习mjpg-streamer的源码。

函数作用:对命令行选项进行解析。

函数出处
头文件getopt.h中:

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

参数介绍
optstring:短选项字符串
longopts: struct option数组,用于存放长选项参数
longindex:用于返回长选项在longopts结构体数组的索引值,用于调试;一般置为NULL

先介绍一下struct option

struct option {
    const char *name;          //长选项名
    int         has_arg;       //是否需要参数
    int        *flag;
    int         val;

};

参数has_arg的值:

# define no_argument 0 //if the option does not take an argument
# define required_argument 1 //if the option requires an argument

# define optional_argument 2 //if the option takes an optional argument

参数flag和val相互依赖,主要分两种情况:
(1)flag为NULL,val值用于确定该长选项,所以需要为长选项指定唯一的val值。这里也为长选项和短选项建立了桥梁。
(2)flag不为NULL,则将val值存放到flag所指向的存储空间,用于标识该长选项出现过。

返回值
(1)短选项: 程序中使用短选项,则返回短选项字符(如‘n’),当需要参数时,则在返回之前将参数存入到optarg中。
(2)0/val值: 程序中使用长选项,返回值根据flag和val值确定。
①当flag为NULL时,返回val值(所以根据val值做不同处理,即val必须唯一)。当val值等于短选项值,则可以使用短选项解析函数解析长选项。
②当flag不为NULL时,则将val值存入flag所指向的存储空间,getopt_long_only()返回0
(3)?: 出现未定义的长选项,函数返回“?”

(4)-1: 解析完所有参数之后返回-1(即当函数解析完参数返回-1之后跳出while循环)

实例
实例1:文件getopt.c源码:

#include <stdio.h>
#include <stdlib.h>
#include <getopt.h> //getopt_long()头文件位置

int main(int argc, char** argv)
{
        const char *optstring = "n:v";
        int c, deb, index;
        struct option opts[] = {
                {"username", required_argument, NULL, 'n'},
                {"version", no_argument, NULL, 'v'},
                {"debug", no_argument, &deb, 1},
                {0,0,0,0}
        };

        while( (c = getopt_long_only(argc, argv, optstring, opts, &index)) != -1)
        {
                switch(c)
                {
                        case 'n':                   //使用-n 或者 --username 指定用户名
                                printf("username is %s\n",optarg);
                                break;
                        case 'v':                  //使用-v 或者--version,输出版本号
                                printf("version is 0.0.1 \n");
                                break;
                        case 0:                     //flag不为NULL
                                printf("debug is %d\n",deb);
                                break;
                        case '?':                     //选项未定义
                                printf("?\n");
                                break;
                        default:
                                printf("c is %d\n",c);
                                break;
                }
        }
        return 0;
}

编译运行结果分析:

$ ./getopt -n won
username is won         
$ ./getopt -v
version is 0.0.1
$ ./getopt -w
./getopt: unrecognized option '-w'
?
$ ./getopt -d
debug is 1

实例2:文件getopt_1.c源码:(有点问题)

#include <stdio.h>
#include <stdlib.h>
#include <getopt.h>

int main(int argc, char** argv)
{
        const char *optstring="n:v";
        int c,deb,index;
        struct option opts[]={
                {"username",required_argument,0,0},
                {"n",required_argument,0,0},
                {"version",no_argument,0,0},
                {"v",no_argument,0,0},
                {"debug",no_argument,0,0},
                {"d",no_argument,0,0},
                {"help",no_argument,0,0},
                {"h",no_argument,0,0}
        };

        while((c=getopt_long_only(argc,argv,optstring,opts,&index))!=-1)
        {
                switch(index){
                        //-n或者--username
                        case 0:
                        case 1:
                                printf("username:%s\n",optarg);
                                break;
                                //-v或者--version
                        case 2:
                        case 3:
                                printf("version:1.0.0\n");
                                break;
                                //-d or --debug
                        case 4:
                        case 5:
                                printf("debug:yes\n");
                                break;
                                //-h or --help
                        case 6:
                        case 7:
                                printf("Help:?\n");
                                break;
                        default:
                                printf("other:%d\n",index);
                                break;
                }
        }
        return 0;

}

执行结果分析:

$ ./getopt_1 --username won --version -d -h
username:won
version:1.0.0
debug:yes
Help:?

$ ./getopt_1 -j
Segmentation fault

你可能感兴趣的:(解析,getopt,命令行选项)