深入解析golang中的标准库flag
Go语言内置的flag包实现了命令行参数的解析,flag包使得开发命令行工具更为简单。
os.Args
如果你只是简单的想要获取命令行参数,可以像下面的代码示例一样使用os.Args来获取命令行参数。
func main() { // 获取命令行参数 // os.Args:[]string if len(os.Args) > 0 { for i, v := range os.Args { fmt.Println(i, v) } } }
执行命令:go run .\main.go host:127.0.0.1 port:8080
输出结果:
C:\Users\mayanan\AppData\Local\Temp\go-build3549800423\b001\exe\main.exehost:127.0.0.1port:8080
os.Args是一个存储命令行参数的字符串切片,它的第一个元素是执行文件的名称。
flag包基本使用
1.flag参数类型
flag包支持的命令行参数类型有bool、int、int64、uint、uint64、float float64、string、duration。
flag参数 | 有效值 |
---|---|
字符串flag | 合法字符串 |
整数flag | 1234、0664、0x1234等类型,也可以是负数。 |
浮点数flag | 合法浮点数 |
bool类型flag | 1, 0, t, f, T, F, true, false, TRUE, FALSE, True, False。 |
时间段flag | 任何合法的时间段字符串。如”300ms”、”-1.5h”、”2h45m”。 合法的单位有”ns”、”us” /“?s”、”ms”、”s”、”m”、”h”。 |
定义命令行flag参数
flag.Type()
基本格式如下:
flag.Type(flag名, 默认值, 帮助信息)*Type例如我们要定义姓名、年龄、婚否三个命令行参数,我们可以按如下方式定义:
func main() { // flag.Type() 的使用 name := flag.String("name", "张三", "姓名") age := flag.Int("age", 18, "年龄") married := flag.Bool("married", false, "婚否") delay := flag.Duration("d", 0, "时间间隔") flag.Parse() fmt.Println(*name, *age, *married, *delay) }
终端输入:
go run .\main.go -name lisi --age 88 -married=true --d=15s
输出:
lisi 88 true 15s
flag.TypeVar()
基本格式如下: flag.TypeVar(Type指针, flag名, 默认值, 帮助信息) 例如我们要定义姓名、年龄、婚否三个命令行参数,我们可以按如下方式定义:
func main() { var name string var age uint var married bool var d time.Duration flag.StringVar(&name, "name", "王五", "姓名") flag.UintVar(&age, "age", 18, "年龄") flag.BoolVar(&married, "m", false, "婚否") flag.DurationVar(&d, "duration", 0, "时间间隔") flag.Parse() fmt.Println(name, age, married, d) }
输入:
go run .\main.go -name lisi --age 35 -m=true --duration=1h15m36s
输出:
lisi 35 true 1h15m36s
flag.Parse()
通过以上两种方法定义好命令行flag参数后,需要通过调用flag.Parse()来对命令行参数进行解析。
支持的命令行参数格式有以下几种:
-flag xxx (使用空格,一个-符号)
--flag xxx (使用空格,两个-符号)
-flag=xxx (使用等号,一个-符号)
--flag=xxx (使用等号,两个-符号)
其中,布尔类型的参数必须使用等号的方式指定。
Flag解析在第一个非flag参数(单个”-“不是flag参数)之前停止,或者在终止符”–“之后停止。
flag其他函数
- flag.Args() ////返回命令行参数后的其他参数,以[]string类型
- flag.NArg() //返回命令行参数后的其他参数个数
- flag.NFlag() //返回使用的命令行参数个数
完整示例
func main() { var name string var age uint var married bool var d time.Duration flag.StringVar(&name, "name", "王五", "姓名") flag.UintVar(&age, "age", 18, "年龄") flag.BoolVar(&married, "m", false, "婚否") flag.DurationVar(&d, "duration", 0, "时间间隔") flag.Parse() fmt.Println(name, age, married, d) // lisi 35 true 1h15m36s fmt.Println(flag.Args()) // [abc true 123] fmt.Println(flag.NArg()) // 3 fmt.Println(flag.NFlag()) // 4 }
输入:
go run .\main.go -name lisi --age 35 -m=true --duration=1h15m36s abc true 123
输出:
lisi 35 true 1h15m36s[abc true 123]34