从alsa play.c 说起 (1)

学习库的最好源码就是从其 utils 源代码学起.
apt-get download alsa-utils. 
先从 aplay/arecord 说起.  cat aplay/aplay.c

1. 命令行选项.
    一般情况下, 命令都会通过命令行导入一下运行时参数 (以 -Type [param]形式), 此时在程序中可以使用 如下类似代码
    简易方式.

#include <unistd.h>
int getopt(int argc, char * const *argv, const char *optstring);
extern char *optarg;
extern int optind, opterr, optopt;

选项在 argv 中以 "-" 为前导,与后续参数之间可带可不带空格连接
getopt是一个需要循环调用的函数，每次返回一个找到的参数， 找不到时返回 -1

每个选项拥有optind变量（从1开始），代表要处理选项在argv中的位置， 此变量可以修改，以便于控制getopt的循环扫描。

optstring 为参数格式化串
    如果后面带有符号：， 则说明此选项后需要额外带有参数， 用 optarg 变量代表此附带参数。
    如果两个：：则代表参数为可选参数，可加可不加， 有时optarg代表参数，无时为NULL。

当命令行中 出现了 optstring 不存在的选项时，不存在选项存储在optopt变量中，getopt函数返回 ‘？’同时在标准错误中输出信息（如果设置了opterr=0，则不会输出）.

范例：
########################################################################################
#define _XOPEN_SOURCE 
#include 
#include 
#include 

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

 opterr = 0;  /* getopt 出现不可识别选项时不要打印错误信息. */         
 while ((opt = getopt(argc, argv, "nt:b::")) != -1)  
 {
 switch (opt) {
 case 'n':
 fprintf(stderr, "option [-n] found.\n");
 break;
 case 'b':
 fprintf(stderr, "option [-b] found. value = [%s]\n", optarg);
 break;      
 case 't':    
 fprintf(stderr, "option [-t] found. value = [%s]\n", optarg);
 break; 
 default: /* '?' or ':' */
 fprintf(stderr, "err-opt[%c] found. value = [%s]\n", opt, optarg);
 }
 }

 if (optind >= argc) {
 fprintf(stderr, "Expected argument after options\n");
 exit(EXIT_FAILURE);
 }

 exit(EXIT_SUCCESS);
}

### 输出 ###
 ### -n -a aa -bbb -t 5 
 option [-n] found.
 err-opt[?] found. value = [(null)]  ### -a aaa
 option [-b] found. value = [bb]   ### b:: 情况下, 参数一定要紧跟着选项
 option [-t] found. value = [5]

还有另外一种方式

#define _GNU_SOURCE

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)

    getopt_long同getopt一样, 但他还支持 -- 的选项.
    getopt_long_only仅支持--, 其optstring应该为空""
    长格式为 --opt[{ |=}arg   ] 即有参数是需以空格或者=为分割,后带参数的格式.

        struct option {
               const char *name;        //选项名称
               int         has_arg;    //常量 no_argument/0, required_argument/1, optional_argument/2 
               int        *flag; //指定函数返回, 一般情况下设置为NULL. 当 flag==NULL,则返回val. 其他情况返回0, 当选项存在时 flag指向要设置成 val 的指针.  
               int         val; //函数返回,或者要设置到flags指针的值.
           };

        longopts 的最后一项必须是0填充, 作为所有选项的结束.
        longindex != NULL 时, 他指向 longopts 其中的一项.
        函数返回同 getopt, 错误是返回 -1, 遇到不认识的返回"?", 否则返回 0 或者val.

范例

#include <stdio.h> /* for printf */
#include <stdlib.h> /* for exit */
#include <getopt.h>

static const char short_options[] = "nlLD:qt:c:f:r:d:MNF:A:R:T:B:vV:IPC" //短格式 - 打头
static const struct option long_options[] = {
        {"list-devnames"/* name */, 0 /*是否有参数*/, 0 /* 返回类型 */, 'n' /*找到name时函数返回值*/},
        {"list-devices", 0, 0, 'l'}, //长格式 -- + name 大头
        {"list-pcms", 0, 0, 'L'}, //返回值一般和短格式的对应, 这样就可以长短格式混用.
        {"device", 1, 0, 'D'},
        {"quiet", 0, 0, 'q'},
        {"file-type", 1, 0, 't'},
        {"channels", 1, 0, 'c'},
        {"format", 1, 0, 'f'},
        {"rate", 1, 0, 'r'},
        {"duration", 1, 0 ,'d'},
        {"mmap", 0, 0, 'M'},
        {"nonblock", 0, 0, 'N'},
        {"period-time", 1, 0, 'F'},
        {"avail-min", 1, 0, 'A'},
        {"start-delay", 1, 0, 'R'},
        {"stop-delay", 1, 0, 'T'},
        {"buffer-time", 1, 0, 'B'},
        {"verbose", 0, 0, 'v'},
        {"vumeter", 1, 0, 'V'},
        {"separate-channels", 0, 0, 'I'},
        {"playback", 0, 0, 'P'},
        {"capture", 0, 0, 'C'},
        {0, 0, 0, 0}  //结束项
};

对应代码

while ((c = getopt_long(argc, argv, short_options, long_options, &option_index)) != -1) {
    switch (c) {
        case 'l': //找到了 --list-devices  或者 -l 选项.
            break;
        case 'D': //找到了 --device=hw:0,0 或者 -Dhw:0,0 选项
            printf("device name is [%s].\n", optarg);
            break;
        default: //找到了不可识别的选项.
            printf("unkown opt [%s].", optopt); //位置选项保存在全局 optopt中.
    }
}