google之gflags
gflags介绍
前段时间公司开发使用glags比较多,在此对其做一下总结,方便后续使用。
gflags主要功能:一把向program传进参数的利器。
gflags使用之define&declare
这点和cpp中定义和使用全局变量的方式很类似:cpp中定义它的default值,hpp中声明以便在其他cpp中使用。
比如:
// foo.h #include "gflags/gflags.h" DECLARE_int32(test_int); // foo.cpp DEFINE_int32(test_int, 1, "test int"); // main.cpp #include "foo.h" int main(int argc, char *argv[]) { google::ParseCommandLineFlags(&argc, &argv, true); // do something with FLAGS_test_int }
gflags之如何在程序中setup flags
(1)bool类型:--noflags_name
// main.cpp DEFINE_bool(test_boolean, true, "test boolean"); // run ./main --notest_boolean
(2)非bool类型:--flag_name=value
gflags之validator
gflags提供了一个接口注册一个函数校验值的有效性,这个函数会在2中情况下被调用:
1. 程序启动的时候:此时如果传入的值不对,那么就直接退出;
2. SetCommandLineOption也会引起调用,这个函数是从新设置value的值;
// foo.h #ifndef __FOO_H_ #define __FOO_H_ #include "gflags/gflags.h" DECLARE_int32(test_int); #endif //__FOO_H_ // foo.cpp #include <iostream> #include "foo.h" using std::cerr; using std::endl; using std::cout; using google::int32; DEFINE_int32(test_int, 1, "test int"); static bool valid_test_int_func(const char *flag_name, int32 value) { if (value < 0 || value > 10) { cerr << "invalid value " << value << " for " << flag_name << endl; return false; } cout << "change value " << value << " for " << flag_name << endl; return true; } static const bool test_int_dummy = google::RegisterFlagValidator(&FLAGS_test_int, &valid_test_int_func); // main.cpp #include <iostream> #include "gflags/gflags.h" #include "foo.h" using namespace std; int main(int argc, char *argv[]) { google::ParseCommandLineFlags(&argc, &argv, true); google::SetCommandLineOption("test_int", "13");
cout << FLAGS_test_int << endl; return 0; }
$ ./output/bin/test_gflags --test_int=99
invalid value 99 for test_int
change value 8 for test_int
ERROR: failed validation of new value '99' for flag 'test_int'
$ ./output/bin/test_gflags --test_int=8
change value 8 for test_int
change value 8 for test_int
invalid value 13 for test_int
8
glags之特殊flags
这里重点介绍--flagfile,直接从配置文件读取flags
// flags.conf --test_int=7 ./output/bin/test_gflags --flagfile=./test/flags change value 7 for test_int change value 7 for test_int invalid value 13 for test_int 7
更多gflags相关内容访问:https://gflags.googlecode.com/git-history/master/doc/gflags.html