[轉]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支持如下類型:html

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函數中加入:python

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

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

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

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

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

printf("%s", FLAGS_mystr);

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

./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有沒有被用戶設定過
  spa

 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以前執行

 

參考:code

相關文章
相關標籤/搜索