google gflags是google使用的一個開源庫，用於解析命令列標記。目前的gflags有C++和Python兩個版本。本文主要介紹gflags的C++版本使用方法。

命令列標記是指使用者在執行可執行程式時，在命令列中指定的引數。例如，對於命令：

1. fgrep -l -f /var/tmp/foo johannes brahms  

則-l及-f /var/tmp/foo是兩個命令列標記，而johnnes和brahms則是命令列引數。一個應用往往具有許多個命令列標記，對應這些標記，可以傳入一些由使用者指定的引數。例如，在上面的例子中，-l標記沒有任何引數，而-f標記的引數則是/var/tmp/foo

這些標記和引數儲存在main函式的argc和argv引數中。一般而言，main函式總有如下的形式：

1. int main(int argc, char ** argv) {…}  

其中argc指明瞭argv陣列的長度，而argv陣列則空格為分割，儲存命令列後用戶輸入的引數。在GNU C Library中，這個工作主要是由getopt函式來完成的。以下是getopt函式的一個例子：

1. #include <ctype.h>
2.  #include <stdio.h>
3.  #include <stdlib.h>
4.  #include <unistd.h>
5.  int
6.  main (int argc, char **argv)  
7.  {  
8.    int aflag = 0;  
9.    int bflag = 0;  
10.    char *cvalue = NULL;  
11.    int index;  
12.    int c;  
13.    opterr = 0;  
14.    while ((c = getopt (argc, argv, "abc:")) != -1)  
15.      switch (c)  
16.        {  
17.        case'a':  
18.          aflag = 1;  
19.          break;  
20.        case
    'b':  
21.          bflag = 1;  
22.          break;  
23.        case'c':  
24.          cvalue = optarg;  
25.          break;  
26.        case'?':  
27.          if (optopt == 'c')  
28.            fprintf (stderr, "Option -%c requires an argument.\n", optopt);  
29.          elseif (isprint (optopt))  
30.            fprintf (stderr, "Unknown option `-%c'.\n", optopt);  
31.          else
32.            fprintf (stderr,  
33.                     "Unknown option character `\\x%x'.\n",  
34.                     optopt);  
35.          return 1;  
36.        default:  
37.          abort ();  
38.        }  
39.    printf ("aflag = %d, bflag = %d, cvalue = %s\n",  
40.            aflag, bflag, cvalue);  
41.    for (index = optind; index < argc; index++)  
42.      printf ("Non-option argument %s\n", argv[index]);  
43.    return 0;  
44.  }  

 在這個例子中可以看出，所有的標記的定義都必須要集中在一個地方處理（也就是switch程式碼段中）。而gflags則與getopt函式不同，在gflags中，標記的定義分散在原始碼中，不需要列舉在一個地方。這意味著單個的原始碼檔案可以定義他們自己所使用的標記，一切連線到這個檔案的應用將獲取這個標記，並且gflags將自動對這個標記進行適當的處理。這對於軟體的靈活性及程式碼的重用是很有好處的。當然，這也產生了一定的風險，特別是，兩個不同的檔案可能會定義擁有同一個名字的命令列標記，在平常的情況下沒有問題，但當這兩個檔案被同一個二進位制程式連線的時候，就會出現錯誤。

gflags使用C++語言實現，其風格也是C++風格的。本文的其餘部分介紹瞭如何使用gflags。

一、如何定義一個命令列標記

使用gflags需要引用gflags標頭檔案：

#include <gflags/gflags.h>

在gflags.h檔案的結尾，定義了一些標記定義巨集，因此在引用了gflags.h後，定義一個命令列標記就變得十分簡單了。如，在foo.cc檔案的開頭，我們引入如下的命令列標記的定義：

1. #include <gflags/gflags.h>
2. DEFINE_bool(big_menu, true, "Include 'advanced' options in the menu listing");  
3. DEFINE_string(languages, "english,french,german”,"comma-separated list of languages to offer in the 'lang' menu");  

在這段程式碼中，我們定義了兩個命令列標記：bool型的big_menu，以及string型的language。所有的DEFINE巨集都有三個引數：標記的名字，預設值，以及針對這個標記的說明。第三個引數是非常有用的，尤其是在構建大型程式的時候，在命令列中使用—help標記可以列出被gflags所定義的所有標記的型別、預設值及對其的說明（也就是巨集第三個引數）。

DEFINE巨集支援的型別包括：

o    DEFINE_bool: boolean

o    DEFINE_int32: 32-bit integer

o    DEFINE_int64: 64-bit integer

o    DEFINE_uint64: unsigned 64-bit integer

o    DEFINE_double: double

o    DEFINE_string: C++ string

可以在可執行程式的任何一個原始檔中定義一個標記，而針對每個標記，只需要定義一次。如果想要在不同的原始檔中訪問該標記，可以使用DECLARE巨集來宣告這個標記（其實就是聲明瞭一個extern變數的引用）。一個更好的方法是，對於一個標記，可以在foo.cc中定義它，並且在foo.h中宣告它。這樣，包含了foo.h的所有原始檔都可以引用這個標記。

二、如何訪問一個標記

訪問標記較為簡單。只要對標記進行了定義或者宣告，那麼只需要在使用它的地方加上字首“FLAGS_”就可以引用這個標記了。如，

1. if (FLAGS_consider_made_up_languages)  
2. FLAGS_languages += ",klingon";   // implied by --consider_made_up_language
3. if (FLAGS_languages.find("finnish") != string::npos)  
4.      HandleFinnish();  

三、在命令列中使用標記

對於上面的foo.cc和foo.h，如果其編譯後產生的二進位制檔案為app_containing_foo，則在命令列中設定這些標記的方法為：

app_containing_foo --nobig_menu -languages="chinese,japanese,korean" …

這個命令會把big_menu設定為false，並且將language設定為“chinese,japanese,Korean”。對於string、int、double等型別的標記，設定標記時使用如下形式：

o    app_containing_foo --languages="chinese,japanese,korean"

o    app_containing_foo -languages="chinese,japanese,korean"

o    app_containing_foo --languages "chinese,japanese,korean"

o    app_containing_foo -languages "chinese,japanese,korean"

這些方式是等價的。但注意gflags不支援短標記與合併標記。如ls –la這種型別，是不能夠被gflags處理的。這和getopt函式有所不同。

 需要注意的還有以下幾點：

1，--連用會終止標記。如命令：foo -f1 1 -- -f2 2，則f2標記將不被處理；

2，bool型的標記，如big_menu，既可以使用—big_menu=true/false，也可以使用—big_menu/--nobig_menu這種方式。gflags都可以解析。

3，使用未被定義的標記將引發嚴重錯誤。

四、在程式中解析標記

在程式中解析標記可以使用如下函式：

1. google::ParseCommandLineFlags(&argc, &argv, true);  

注意argc和argv均以地址方式傳遞，也就是該函式可以改變argc和argv的內容。通常這段程式碼會出現在main函式的開始。最後一個引數是移除標記，它指明瞭是否將被gflags成功解析的標記從引數列表中移除。例如，對於命令列：

foo –options=start file1 file2

在這個命令列中，options是一個命令列標記，將被gflags解析（如果它已經被定義了）；而file1和file2則是命令列引數。如果設定remove標記位ture，則—options=start會在呼叫ParseCommandLineFlags後被移除，此時argc=2，而argv中則儲存了file1和file2兩個引數。如果remove標記位設為false，則—options=start將不會被移除，則argc不會改變，但argv會重新排列，將所有的標記排列在前面。

學習資料參考於：

<<用Google的gflags優雅的解析命令列引數>>

http://www.leoox.com/?p=270

<<google gflag使用指南>>

http://blog.csdn.net/starays/article/details/7990984