用getopt()处理命令行多参数(翻译)

/***************************************************
/*
/*题目：FreeBSD-ManPage-getopt(3)
/*
/*翻译：Patrick
/*
/*时间：2004-8-24
/*
/***************************************************
名字
    getopt -- get option character from command line argument list

库
    标准c库 (libc,-lc)

定义
    #include <unistd.h>

    extern char *optarg;
    extern int optind;
    extern int optopt;
    extern int opterr;
    extern int optreset;

    int
    getopt(int argc, char * const *argv, const char *optstring);

描述
    这个getopt()函数分析一个命令行参数列argv，并返回下一个已知的选项(option)。如果一个选项在可接受选项串optstring中列出，那么它就是已知的。

    这个选项串optstring可以包含下列元素：单个字符，字符后面接一个冒号说明后面跟随一个选项参数。例如，一个选项字符"x"表示选项"-x"，选项字符"x:"表示选项和其参数"-x argument"。一个跟随的参数argument是否引导一个空格与getopt()无关。

    在getopt()的返回中，optarg指向选项参数，如果它是anticipated，并且变量optind包含下一个argv参数作为对getopt()下一次调用的索引。变量optopt保存最后一个由getopt()返回的已知的选项。

    变量opterr和optind都被初始化为1。变量optind可能在对getopt()的调用前已设成其他值的调用前，为了略去或多或少的argv入口。

    为了使用getopt()来处理多组参数，或多次处理单组参数，变量optreset必须在每一个对getopt()附加的调用前设置成1，并且变量optind必须已被初始化。

    当参数列已经到尾时getopt()函数返回-1，或者返回'?'当遇到一个未知的选项。参数列中选项的解释可能会被'--'取消，由于它引起getopt()给参数处理发送结束信号并返回-1。当所有的选项都被处理后(比如一直到第一个非选项参数)，getopt()返回-1。

诊断
    如果getopt()函数遇到一个在optstring中没有的字符或检测到一个缺选项的参数，它会向stderr中写一个错误信息并返回'?'。将opterr置0可以使它不向stderr中写错误信息。如果optstring以':'开头，那么一个却选项的参数会使':'返回除suppressing之外的任何错误信息。

    选项参数允许使用"-"开头；这是合理的，但可能减少错误检测的总数。

扩展
    变量optreset的增加使多次调用getopt()函数成为可能。这是IEEE 1003.2(POSIX.2)规范的扩展部分。

举例
    int bflag, ch, fd;

    bflag = 0;
    while ((ch = getopt(argc, argv, "bf:")) != -1)
     switch (ch) {
     case 'b':
      bflag = 1;
      break;
     case 'f':
      if ((fd = open(optarg, O_RDONLY, 0)) < 0)
       err(1, "%s", optarg);
      break;
     case '?':
     default:
      usage();
     }
    argc -= optind;
    argv += optind;

历史
    getopt()函数首次出现于4.3BSD。

BUGS
    getopt()函数曾经返回EOF代替-1。这在IEEE 1003.2-1992(POSIX.2)中被改回来了。

    一个单破折号"-" 可能在optstring被定义成一个字符，可能永远不会有参数联合使用它。这允许getopt()在程序中使用"-"作为参数标志。这种习惯是错的，并且不会被用在任何当前的开发中。这只是为了向后兼容。默认的，一个单破折号"-"使getopt()返回-1。这个和System V兼容。

    还可能处理数字作为选项字符情况。这允许getopt()在程序中使用数字("-3")作为参数。这种习惯是错的，并且不会被用在任何当前的开发中。只是提供向后兼容。下面的这段代码在很多情况下(不是所有)工作。

    int length;
    char *p, *ep;

    while ((ch = getopt(argc, argv, "0123456789")) != -1)
     switch (ch) {
     case '0': case '1': case '2': case '3': case '4':
     case '5': case '6': case '7': case '8': case '9':
      p = argv[optind - 1];
      if (p[0] == '-' && p[1] == ch && !p[2])
       length = strtol(++p, &ep, 10);
      else if (argv[optind] && argv[optind][1] == ch) {
       length = strtol((p = argv[optind] + 1),
           &ep, 10);
       optind++;
       optreset = 1;
      } else
       usage();
      if (*ep != ' ')
       errx(EX_USAGE, "illegal number -- %s", p);
      break;
     }

FreeBSD 4.10   April 27, 1995     FreeBSD 4.10

/******************The End***********************

这是FreeBSD的ManPage，getopt用来处理命令行参数组合问题。

HTH~~

原文转自：http://www.ltesting.net