说起 golang 的 flag 个包,我们第一反应的是什么呢?至少我曾经第一次看到 flag 包的时候,第一反应是想起写 C 语言的时候咱们用于定义一个表示的,我们一般会命名为 flag 变量
实际上 golang 的 flag 包是用于处理命令行参数的工具包,我们可以基于这个包来开发自定义的命令行工具
对于命令行,相信大家都不陌生吧,学过 C 的就知道,如下代码是否很熟悉
int main(int argc,char **argv) { // 打印 agrc 和 argv return 0; }
其中 argc 表示命令行的参数个数, argv 二级指针表示实际的命令参数
那么,对于咱们的 golang 是如何玩的,咱们先写个 demo 看看效果
main.go
func main() { if len(os.Args) > 0 { fmt.Println("len(os.Args) == ", len(os.Args)) for _, v := range os.Args { fmt.Println(v) } } }
效果如下:
咱们 go build 输出程序名为 testFlag 的可执行程序,如下运行即可
当然需要看非常详细和全面的关于 flag 包的内容,可以直接查看官方文档 ,此处咱们是对 flag 包的介绍,平常都会使用到的一些功能,以及注意事项,分别从如下 3 个小点介绍一下常用的功能
- 注册 flag 和 Flag 解析支持的数据类型
- 绑定 flag 变量
- flag.Parse() 的使用方式
注册 flag 和 Flag 解析支持的数据类型
我们可以看到上述简单 demo 演示的是咱们运行可执行程序的时候追加我们期望的参数
实际上我们使用的比较多的是在程序内部去设置 flag,例如一般写 web 服务器的时候,就会去使用 flag 包设置端口
咱们在程序中使用 flag 包,定义一个端口
通过效果,我们可看到,咱们使用 flag 包来设置命令行参数时,实际上返回的是一个指针,这个地方可别弄错了
在我们的代码中,我们可以看到 flag 包他支持这么多数据类型的注册,如下:
- 基本的 int,int64,uint,uint64 ,整数的 flag 支持这些进制的:1234、0664、0x1234
- 布尔值,bool , 布尔值可以这样来写:1, 0, t, f, T, F, true, false, TRUE, FALSE, True, False
- 浮点数,float,float64
- 字符串,string
- 时间段 duration 也是支持的很好的,例如:我们可以设置为 100ms,1h,1us,1h25m 等等都是可以的
那么对应到咱们去设置各种数据类型的命令行参数的时候,我们就可以简单的使用 flag 包对应的函数即可,如:
port := flag.Int("port", 8866, "端口") name := flag.String("name", "小猪", "姓名") money := flag.Float64("money",10.36,"钱")
其他的照葫芦画瓢就可以了,这些函数的参数都是一样的效果
- 参数1 flag 名称
- 参数2 默认值
- 参数3 帮助信息
这里再来敲一下黑板,上述的 port,name,money 都是指针类型的哦
绑定 flag 变量
如果用不习惯上述方式来注册 flag 的话,我们也是可以先定义一个变量,然后将命令行参数绑定到变量上,如:
var city string var food string var age int flag.StringVar(&city,"city","beijing","城市") flag.StringVar(&food,"food","roast duck","美食") flag.IntVar(&age,"age",18,"年龄")
在 flag 包中,我们可以看到也有一堆关于各种数据类型绑定变量的函数
如:flag.StringVar(&city,"city","beijing","城市")
参数类型和上述说到的类似,多了一个参数放在最前面
- 参数1 具体的变量地址
- 参数2 flag 名称
- 参数3 默认值
- 参数4 帮助信息
flag.Parse() 的使用方式
前面说了那么多的铺垫,那么我应该如何来使用呢?不可能我们都只去使用默认值吧
自然是自己开发自定义的命名行工具提供出去使用咯,这就需要咱们使用 flag.Parse() 了
flag.Parse() 来解析命令行参数写入注册的 flag 里,解析出来的是值,还是指针,这个取决于上面咱们注册 flag 的方式,再次敲黑板,此处可别弄错了
例如咱们写一个简单的 demo
此处,我们可以看到 port 是注册的自身的flag 的,port 是一个指针,所以咱们通过 flag.Parse() 之后,使用 port 时需要取地址
咱们可以参看效果如下:
编译执行可执行程序之后,我们可以看到,输出的是默认值,另外,咱们机上 --help
参数,就可以看到我们编写的帮助信息
站在使用者的角度,去使用这个工具,按照提示输入相关信息之后,我们可以看到输出的结果是我们所期望的
当然此处需要提几个注意事项:
- 上述我们可以看到,咱们给对应的 flag 传值的时候是,
-flag xxx
,我们也是可以--flag xxx
,我们还可以-flag=xxx
,同理--flag=xxx
也是 ok 的
当然,如果对 golang 自身对于 flag 包的实现方式感兴趣的兄弟,也可以好好看看 flag 包中对于命名行参数的字符串数据解析
func (f *FlagSet) ``parseOne``() (bool, error) {
感谢阅读,欢迎交流,点个赞,关注一波 再走吧
欢迎点赞,关注,收藏
朋友们,你的支持和鼓励,是我坚持分享,提高质量的动力
好了,本次就到这里
技术是开放的,我们的心态,更应是开放的。拥抱变化,向阳而生,努力向前行。
我是阿兵云原生,欢迎点赞关注收藏,下次见~
可以进入地址进行体验和学习:https://xxetb.xet.tech/s/3lucCI