［轉］Google gflags使用說明

gflags是什麼：

gflags是google的一個開源的處理命令行參數的庫，使用c++開發，具有python接口，能夠替代getopt。

gflags使用起來比getopt方便，可是不支持參數的簡寫（例如getopt支持--list縮寫成-l，gflags不支持）。

如何安裝使用gflags：

安裝：請訪問地址 https://code.google.com/p/gflags/，下載最新版的gflags，編譯安裝。

使用：

1.首先須要include "gflags.h"

#include <gflags/gflags.h>

2.將須要的命令行參數使用gflags的宏：DEFINE_xxxxx(變量名，默認值，help-string) 定義在文件當中，注意全局域哦。gflags支持如下類型：

DEFINE_bool: boolean

DEFINE_int32: 32-bit integer

DEFINE_int64: 64-bit integer

DEFINE_uint64: unsigned 64-bit integer

DEFINE_double: double

DEFINE_string: C++ string

3.在main函數中加入：

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

    argc和argv想必你們都很清楚了，說明如下第三個參數的做用：

   若是設爲true，則該函數處理完成後，argv中只保留argv[0]，argc會被設置爲1。

   若是爲false，則argv和argc會被保留，可是注意函數會調整argv中的順序。

4.這樣，在後續代碼中可使用FLAGS_變量名訪問對應的命令行參數了

printf("%s", FLAGS_mystr);

5.最後，編譯成可執行文件以後，用戶可使用：executable --參數1=值1 --參數2=值2 ... 來爲這些命令行參數賦值。

./mycmd --var1="test" --var2=3.141592654 --var3=32767 --mybool1=true --mybool2 --nomybool3

這裏值得注意的是bool類型命令行參數，除了可使用--xxx=true/false以外，還可使用--xxx和--noxxx後面不加等號的方式指定true和false

gflags進階使用：

1.在其餘文件中使用定義的flags變量：有些時候須要在main以外的文件使用定義的flags變量，這時候可使用宏定義DECLARE_xxx(變量名)聲明一下（就和c++中全局變量的使用是同樣的，extern一下同樣）

DECLARE_bool: boolean
DECLARE_int32: 32-bit integer
DECLARE_int64: 64-bit integer
DECLARE_uint64: unsigned 64-bit integer
DECLARE_double: double
DECLARE_string: C++ string

在gflags的doc中，推薦在對應的.h文件中進行DECLARE_xxx聲明，須要使用的文件直接include就好了。

 2.檢驗輸入參數是否合法：gflags庫支持定製本身的輸入參數檢查的函數，以下：

static bool ValidatePort(const char* flagname, int32 value) {
   if (value > 0 && value < 32768)   // value is ok
     return true;
   printf("Invalid value for --%s: %d\n", flagname, (int)value);
   return false;
}
DEFINE_int32(port, 0, "What port to listen on");
static const bool port_dummy = RegisterFlagValidator(&FLAGS_port, &ValidatePort);

3.判斷flags變量是否被用戶使用：在gflags.h中，還定義了一些日常用不到的函數和結構體。這裏舉一個例子，判斷參數port有沒有被用戶設定過
  

 google::CommandLineFlagInfo info;
    if(GetCommandLineFlagInfo("port" ,&info) && info.is_default) {
        FLAGS_port = 27015;
    }

4.定製你本身的help信息與version信息：(gflags裏面已經定義了-h和--version，你能夠經過如下方式定製它們的內容)

 

version信息：使用google::SetVersionString設定，使用google::VersionString訪問
help信息：使用google::SetUsageMessage設定，使用google::ProgramUsage訪問
注意：google::SetUsageMessage和google::SetVersionString必須在google::ParseCommandLineFlags以前執行

 

參考：

• https://code.google.com/p/gflags/
• https://gflags.googlecode.com/git-history/master/doc/gflags.html#flagfiles