使用getopt_long()从命令行获取参数

众所周知,C程序的主函数有两个参数,其中,第一个参数是整型,可以获得包括程序名字的参数个数,第二个参数是字符数组指针或字符指针的指针,可以按顺序获得命令行上各个字符串参数。其原形是:

int main(int argc, char *argv[]);

或者

int main(int argc, char **argv);

 

如果有一个解析CDR的程序,名叫destroy,负责将一个二进制格式的CDR文件转换为文本文件,输出的文本的样式由另外一个描述文件定义,那么,命令行要求输入的参数就有三个:CDR文件名、输出文件名和描述文件名。其中,前两个参数是必须输入的,第三个的描述文件名可以不输入,程序会自动采用默认的输出样式。很自然,主函数的三个参数就应该这样排列:

./destroy cdr cdr.txt [cdr.desc]

 

这样做在一般情况下不会有太大问题,问题来源于扩展性的需求。如果有一天,用户要求解析程序能够按关键字解析,只有含有关键字的CDR才能够输出。解决方法很简单,只要在参数列表的最后,加上它就可以了。不过,这样就使得原本可选的描述文件名变为必须输入:

./destroy cdr cdr.txt cdr.desc [keyword]

 

因为不改的话,你就不知道,第三个参数究竟是描述文件名,还是关键字。现在还算好办,如果以后陆续有增加参数的需求,关键字也变成必须输入了,这个时候,如果要查找全部CDR,你还得定义一个“特殊的关键字”,告诉程序,把数据统统给我捞出来……

 

有鉴于此,在Unix/Linux的正式的项目上,程序员通常会使用getopt()或者getopt_long()来获得输入的参数。两者的一个区别在于getopt()只支持短格式参数,而getopt_long()既支持短格式参数,又支持长格式参数。

短格式:./destroy -f cdr -o cdr.txt -c cdr.desc -k 123456

长格式:./destroy --file cdr --output cdr.txt --config cdr.desc --keyword 123456

 

引入了getopt()和getopt_long()的项目,设计者可以按需要,方便地增加参数,或者随意地放置参数的先后次序,只需要在程序中判断,哪些参数是必须的就可以了。关于这两个函数的用法,大家可以上网搜索一下,不再累述。附件destroy_linux.c给出了在Linux下使用getopt_long()的实例。


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

void  print_usage( const   char   * program_name)  {
    printf(
"%s 1.0.0 (2010-06-13)\n", program_name);
    printf(
"This is a program decoding a BER encoded CDR file\n");
    printf(
"Usage: %s -f <file_name> -o <output_name> [-c <config_name>] [-k <keyword>]\n", program_name);
    printf(
"    -f --file       the CDR file to be decoded\n");
    printf(
"    -o --output     the output file in plain text format\n");
    printf(
"    -c --config     the description file of the CDR file, if not given, use default configuration\n");
    printf(
"    -k --keyword    the keyword to search, if not given, all records will be written into output file\n");
}


int  main( int  argc,  char   * argv[])  {
    
char *file_name = NULL;
    
char *output_name = NULL;
    
char *config_name = NULL;
    
char *keyword = NULL;

    
const char *short_opts = "hf:o:c:k:";
    
const struct option long_opts[] = {
        
{"help", no_argument, NULL, 'h'},
        
{"file", required_argument, NULL, 'f'},
        
{"output", required_argument, NULL, 'o'},
        
{"config", required_argument, NULL, 'c'},
        
{"keyword", required_argument, NULL, 'k'},
        
{0000}
    }
;
    
int hflag = 0;

    
int c;
    opterr 
= 0;

    
while ( (c = getopt_long(argc, argv, short_opts, long_opts, NULL)) != -1 ) {
        
switch ( c ) {
            
case 'h' :
                hflag 
= 1;
                
break;
            
case 'f' :
                file_name 
= optarg;
                
break;
            
case 'o' :
                output_name 
= optarg;
                
break;
            
case 'c' :
                config_name 
= optarg;
                
break;
            
case 'k' :
                keyword 
= optarg;
                
break;
            
case '?' :
                
if ( optopt == 'f' || optopt == 'o' || optopt == 'c' || optopt == 'k' )
                    printf(
"Error: option -%c requires an argument\n", optopt);
                
else if ( isprint(optopt) )
                    printf(
"Error: unknown option '-%c'\n", optopt);
                
else
                    printf(
"Error: unknown option character '\\x%x'\n", optopt);
                
return 1;
            
default :
                abort();
        }

    }


    
if ( hflag || argc == 1 ) {
        print_usage(argv[
0]);
        
return 0;
    }

    
if ( !file_name ) {
        printf(
"Error: file name must be specified\n");
        
return 1;
    }

    
if ( !output_name ) {
        printf(
"Error: output name must be specified\n");
        
return 1;
    }


    
// if not setting default, Linux OK, but SunOS core dump
    if ( !config_name ) config_name = "(null)";
    
if ( !keyword ) keyword = "(null)";
    printf(
"Parameters got: file_name = %s, output_name = %s, config_name = %s, keyword = %s\n", file_name, output_name, config_name, keyword);
    
return 0;
}



另外一个区别是,getopt()几乎通用于所有类Unix系统,而getopt_long()只有在GNU的Unix/Linux下才能用。如果把上述程序放到Tru64上编译,就会出现以下错误:

cc -o destroy destroy_linux.c

cc: Error: destroy_linux.c, line 24: In the initializer for long_opts, an array's element type is incomplete, which precludes its initialization. (incompelinit)

                {"help", no_argument, NULL, 'h'},

----------------^

 

所以,如果一定要在Tru64等非GNU的OS上做到长格式的效果,除了自己另起炉灶之外,基本上只好借助一些跨平台的开源项目了。附件里的getopt_long.c和getopt.h是从opensolaris的网站上抄下来的,是包含在sg3_utils软件包中的程序。sg3_utils具体是什么,我也不知道,据说是一个Linux的开发包,用来直接使用SCSI命令集访问设备。(sg3_utils is a package of utilities for accessing devices that use SCSI command sets.)反正拿来能用就是了!


点击下载getopt_long

拿过来后,把他们放到与destroy_linux.c同一目录下,只需要把destroy_linux.c的头文件改一个地方,#include <getopt.h>改为#include “getopt.h”,就能够编译运行了。而且,这样改好后,不仅在Tru64上能运行,在Linux、SunOS上也能运行。

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

void  print_usage( const   char   * program_name)  {
    printf(
"%s 1.0.0 (2010-06-13)\n", program_name);
    printf(
"This is a program decoding a BER encoded CDR file\n");
    printf(
"Usage: %s -f <file_name> -o <output_name> [-c <config_name>] [-k <keyword>]\n", program_name);
    printf(
"    -f --file       the CDR file to be decoded\n");
    printf(
"    -o --output     the output file in plain text format\n");
    printf(
"    -c --config     the description file of the CDR file, if not given, use default configuration\n");
    printf(
"    -k --keyword    the keyword to search, if not given, all records will be written into output file\n");
}


int  main( int  argc,  char   * argv[])  {
    
char *file_name = NULL;
    
char *output_name = NULL;
    
char *config_name = NULL;
    
char *keyword = NULL;

    
const char *short_opts = "hf:o:c:k:";
    
const struct option long_opts[] = {
        
{"help", no_argument, NULL, 'h'},
        
{"file", required_argument, NULL, 'f'},
        
{"output", required_argument, NULL, 'o'},
        
{"config", required_argument, NULL, 'c'},
        
{"keyword", required_argument, NULL, 'k'},
        
{0000}
    }
;
    
int hflag = 0;

    
int c;
    opterr 
= 0;

    
while ( (c = getopt_long(argc, argv, short_opts, long_opts, NULL)) != -1 ) {
        
switch ( c ) {
            
case 'h' :
                hflag 
= 1;
                
break;
            
case 'f' :
                file_name 
= optarg;
                
break;
            
case 'o' :
                output_name 
= optarg;
                
break;
            
case 'c' :
                config_name 
= optarg;
                
break;
            
case 'k' :
                keyword 
= optarg;
                
break;
            
case '?' :
                
if ( optopt == 'f' || optopt == 'o' || optopt == 'c' || optopt == 'k' )
                    printf(
"Error: option -%c requires an argument\n", optopt);
                
else if ( isprint(optopt) )
                    printf(
"Error: unknown option '-%c'\n", optopt);
                
else
                    printf(
"Error: unknown option character '\\x%x'\n", optopt);
                
return 1;
            
default :
                abort();
        }

    }


    
if ( hflag || argc == 1 ) {
        print_usage(argv[
0]);
        
return 0;
    }

    
if ( !file_name ) {
        printf(
"Error: file name must be specified\n");
        
return 1;
    }

    
if ( !output_name ) {
        printf(
"Error: output name must be specified\n");
        
return 1;
    }


    
// if not setting default, Linux OK, but SunOS core dump
    if ( !config_name ) config_name = "(null)";
    
if ( !keyword ) keyword = "(null)";
    printf(
"Parameters got: file_name = %s, output_name = %s, config_name = %s, keyword = %s\n", file_name, output_name, config_name, keyword);
    
return 0;
}



Linux下编译

-bash-3.2$ gcc -o destroy destroy.c getopt_long.c

短格式,全部输入

-bash-3.2$ ./destroy -f aaa -o aaa.txt -c ccc -k 222

Parameters got: file_name = aaa, output_name = aaa.txt, config_name = ccc, keyword = 222

前两个长格式,后两个短格式

-bash-3.2$ ./destroy --file aaa --output aaa.txt -c ccc -k 222

Parameters got: file_name = aaa, output_name = aaa.txt, config_name = ccc, keyword = 222

漏掉一个必须输入的参数会报错

-bash-3.2$ ./destroy -output aaa.txt

Error: file name must be specified

次序随意,长短混用

-bash-3.2$ ./destroy -c ccc -o aaa.txt -k 222 --file aaa

Parameters got: file_name = aaa, output_name = aaa.txt, config_name = ccc, keyword = 222

 

题外话,#include <filename.h>与#include “filename.h”有什么区别,是面试C程序员经常问到的一个问题。答案大家都知道了,#include <filename.h>,编译器从标准库路径搜索filename.h,而#include “filename.h”,编译器从用户的工作路径搜索filename.h。

 

此外,网上也有人说从glibc(http://sourceware.org/glibc/)上把getopt.h、getopt.c和getoptl.c拿过来也能够用。我也试过,但是不清楚什么原因不成功。

 

在这个小实验的过程中,还发现了C语言在各个OS下的一些细小差异,比如destroy.c里,79行到82行:

//  if not setting default, Linux OK, but SunOS core dump
if  (  ! config_name ) config_name  =   " (null) " ;
if  (  ! keyword ) keyword  =   " (null) " ;
printf(
" Parameters got: file_name = %s, output_name = %s, config_name = %s, keyword = %s\n " , file_name, output_name, config_name, keyword);


 

如果不设置空指针的默认值,Linux和Tru64都会自动帮你转换而避免运行时错误,但是SunOS不会,它会死给你看。

./destroy -f aaa -o aaa.txt

Segmentation Fault (core dumped)

 

再比如,第62行的abort()在头文件stdlib.h中定义,如果不包含此文件,SunOS与Tru64编译都没问题,Linux编译时会警告:

warning: incompatible implicit declaration of built-in function abort

 

由此看来,虽然C也公认是可移植性比较好的语言,但是在跨平台的项目中,也应该注意这些微小的差别。


本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/yui/archive/2010/06/13/5669922.aspx

你可能感兴趣的:(使用getopt_long()从命令行获取参数)