linux的命令列解析引數之getopt_long函式使用

小魚仙官發表於2020-05-08

命令列引數更加清晰: 

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

static char* dev_name;
static int number;

static void usage(FILE *fp, int argc, char **argv)
{
    fprintf(fp,
            "Usage: %s [options]\n\n"
            "Version 1.3\n"
            "Options:\n"
            "-d | --device name  Device name [%s] \n"
            "-h | --help Print this message\n"
            "-o | --output Output digital [%d]\n"
            "",
            argv[0], dev_name, number);
}

//optstring: 表示短選項字串。
//    形式如“a:b::cd:“,分別表示程式支援的命令列短選項有-a、-b、-c、-d,冒號含義如下:
//    (1)只有一個字元,不帶冒號——只表示選項, 如-c
//    (2)一個字元,後接一個冒號——表示選項後面帶一個引數,如-a 100
//    (3)一個字元,後接兩個冒號——表示選項後面帶一個可選引數,即引數可有可無,如果帶引數,則選項與引數直接不能有空格 形式應該如-b200

static const char optstring[] = "d:ho::";

static const struct option long_options[] = {
//        {const char* name, int has_arg, int *flag, int val}
//        (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。

        {"device", required_argument, NULL, 'd'},
        {"help", no_argument, NULL, 'h'},
        {"output", required_argument, NULL, 'o'},
        {0, 0, 0, 0},
};

//全域性變數:
//        (1)optarg:表示當前選項對應的引數值。
//        (2)optind:表示的是下一個將被處理到的引數在argv中的下標值。
//        (3)opterr:如果opterr = 0,在getopt、getopt_long、getopt_long_only遇到錯誤將不會輸出錯誤資訊到標準輸出流。opterr在非0時,向螢幕輸出錯誤。
//        (4)optopt:表示沒有被未標識的選項。
//返回值:
//         (1)如果短選項找到,那麼將返回短選項對應的字元。
//         (2)如果長選項找到,如果flag為NULL,返回val。如果flag不為空,返回0
//         (3)如果遇到一個選項沒有在短字元、長字元裡面。或者在長字元裡面存在二義性的,返回“?”
//         (4)如果解析完所有字元沒有找到(一般是輸入命令引數格式錯誤,eg: 連斜槓都沒有加的選項),返回“-1”
//         (5)如果選項需要引數,忘了新增引數。返回值取決於optstring,如果其第一個字元是“:”,則返回“:”,否則返回“?”。
//注意:
//        (1)longopts的最後一個元素必須是全0填充,否則會報段錯誤
//        (2)短選項中每個選項都是唯一的。而長選項如果簡寫,也需要保持唯一性。


int main(int argc, char **argv)
{
    printf("Hello World!\n");

    dev_name = "/dev/video0";
    number = 1314;

    while (1) {
        int c = 0;

        c = getopt_long(argc, argv, optstring, long_options, NULL);

        if(-1 == c)
            break;

        switch (c) {
        case 'd':
//            dev_name = strdup(optarg);
//            printf("new dev name is [%s]\n", dev_name);
            dev_name = realpath(optarg, NULL); //保證輸入的optarg是真實存在的,否者輸出為null
            printf("new dev name is [%s]\n", dev_name);
            break;
        case 'h':
            usage(stdout, argc, argv);
            break;
        case 'o':
            number = atoi(optarg);
            printf("new output digital is [%d]\n", number);
            break;
        default:
            usage(stderr, argc, argv);
            exit(EXIT_FAILURE);
        }
    }

    return 0;
}

編譯:gcc main.c -o main

執行:./main -d /dev/ttyUSB0         輸出:new dev name is [/dev/ttyUSB0]

          ./main -o500                          輸出:new output digital is [500]     注:-o500間不能有空格,若有空格則會段錯誤

          ./main -h                                輸出:Usage: ./a.out [options]

                    Version 1.3
                    Options:
                    -d | --device name  Device name [/dev/video0] 
                    -h | --help Print this message
                    -o | --output Output digital [1314]

         

  ./main -e                                 輸出錯誤資訊:./a.out: invalid option -- 'e'

                                                                              Usage: ./a.out [options]

                               Version 1.3
                               Options:
                               -d | --device name  Device name [/dev/video0] 
                               -h | --help Print this message
                               -o | --output Output digital [1314]

 

相關文章