理解Go语言组件flag

2022-10-09,,,

作用

主要用来实现命令行的参数解析,以达到实现以下效果的目的

$ cmd -flagname 123

使用方式

flag是go语言的内置包,能接收的参数类型主要有字符串、布尔和数值类型。

方式一

func main() {
  var ip = flag.string("ip", "127.0.0.1", "此处传入ip地址")
  flag.parse()
  fmt.println(*ip)
}

我们在main函数中调用flag.string函数来定义命令,该函数共有三个参数

  • 第一个参数是命令名称
  • 第二个参数为默认值,也就是不传ip时默认拿到的值
  • 第三个参数是给用户的提示

同时该函数返回的是指针类型,打印变量ip时记得加上指针符号来输出地址对应的值。在执行flag.string后,记得执行flag.parse来解析命令,否则不能执行成功。我们来测试一下,先键入一个错的参数,会得到以下提示。

go run main.go -i

flag provided but not defined: -i
usage of /var/folders/3s/5v6r481x17x5ks_7q1dzmlsw0000gp/t/go-build400337564/b001/exe/main:
  -ip string
        此处传入ip地址 (default "127.0.0.1")

加上-ip参数和值,可以直接获取到对应的值

go run main.go -ip 192.168.1.1

192.168.1.1

除了-ip 192.168.1.1这种形式外,以等号赋值的方式也是支持的

go run main.go -ip=192.168.1.1

192.168.1.1

现在什么都不传,可以直接拿到设置的默认值

go run main.go

127.0.0.1

方式二

除上述内容之外,还有一种写法,我们再增加一个端口号为例

var port int

func init() {
	flag.intvar(&port, "port", 80, "端口号")
}

func main() {
	flag.parse()
	fmt.println("port", port)
}

首先定义一个整型变量port,在init函数中调用flag.intvar函数,该函数与flag.string相比,少了返回值,且多一个参数,第一个参数是预先定义好的变量,为了方便intvar内部修改变量值,所以该参数传引用类型。

方式三

如果我们想在接收参数值的过程当中做一些处理,那么也可以自己进行实现。假如我们需要对传入的用户名user进行处理,加上一个_suffix后缀。

type user string

func (u *user) string() string {
	return fmt.sprint(*u)
}

func (u *user) set(value string) error {
	if len(value) < 3 {
		return errors.new("姓名长度不得小于3位")
	}
	*u = user(value + "_suffix")
	return nil
}

首先需要定义一个类型,然后实现两个方法string与set,在set方法中我对传入的值进行了长度判断,如果小于3个字符就抛出错误,否则就将传入的值拼接一个后缀_suffix

var userflag user

func main() {
	flag.var(&userflag, "user", "用户名")
	flag.parse()
	fmt.println(userflag)
}

接下来定义一个user类型的变量,然后在main函数中调用flag.var方法,将变量地址传入,接下来执行命令做测试。

go run flagvar.go -user pingye
pingye_suffix

成功拼接上了后缀。

go语言组件学习示例开源库,欢迎star
https://github.com/enochzg/golang-examples

《理解Go语言组件flag.doc》

下载本文的Word格式文档,以方便收藏与打印。