: error c2062: 意外的类型“int”_Go 命令行解析 flag 包之扩展新类型
![](/assets/blank.gif)
上篇文章 说到,除布尔类型 Flag
,flag 支持的还有整型(int、int64、uint、uint64)、浮点型(float64)、字符串(string)和时长(duration)。
flag 内置支持能满足大部分的需求,但某些场景,需要自定义解析规则。一个优秀的库肯定要支持扩展的。本文将介绍如何为 flag 扩展一个新的类型支持?
扩展目标
在 gvg
这个小工具中,list
子命令支持获取 Go 的版本列表。但版本的信息来源有多处,比如 installed
(已安装)、local
(本地仓库)和 remote
(远程仓库)。
查看下 list
的帮助信息,如下:
NAME:gvg list - list go versionsUSAGE:gvg list [command options] [arguments...]OPTIONS:--origin value the origin of version information , such as installed, local, remote (default: "installed")
可以看出,list
子命令支持一个 Flag
选项,--origin
。它用于指定版本信息的来源,允许值的范围是 installed
、local
和 remote
。
如果要求不严格,用 StringVar
也可以实现。但问题是,使用 String
,即使输入不在指定范围也能成功解析,不够严谨。虽说在获取后也可以检查,但还是不够灵活、可配置型也差。
接下来,我们要实现一个新的类型的 Flag
,使选项的值必需在指定范围,否则要给出一定的错误提示信息。
实现思路
如何展一个新类型呢?
可以参考 flag 包内置类型的实现思路,比如 flag.DurationVar
。Duration
不是基础类型,解析结果是存放到了 time.Duration
类型中,可能更有参考价值。
进入到 flag.DurationVar
查看源码,如下:
func DurationVar(p *time.Duration, name string, value time.Duration, usage string) {CommandLine.Var(newDurationValue(value, p), name, usage)
}
通过 newDurationValue
创建了一个类型为 durationValue
的变量,并传入到了 CommandLine.Var
方法中。
如果继续往下追,会根据 Value 创建一个 Flag
变量。 如下:
func (f *FlagSet) Var(value Value, name string, usage string) {flag := &Flag{name, usage, value, value.String()}...
}
从 Var
的定义可以看出,它的第一个参数类型是 Value
接口类型,也就说,durationValue 是实现了 Value
接口的类型。
注意,源码中出现的 FlagSet
可以先忽略,它是下篇介绍子命令时重点关注的对象。
看下 Value
的定义,如下:
type Value interface {String() stringSet(string) error
}
那么,durationValue
的实现代码如何?
// 传入参数分别是默认值和获取 Flag 值的变量地址
func newDurationValue(val time.Duration, p *time.Duration) *durationValue {// 将默认值设置到 p 上*p = val// 使用 p 创建新的类型,保证可以获取到解析的结果return (*durationValue)(p)
}// Set 方法负责解析传入的值
func (d *durationValue) Set(s string) error {v, err := time.ParseDuration(s)if err != nil {err = errParse}*d = durationValue(v)return err
}// 获取真正的值
func (d *durationValue) String() string { return (*time.Duration)(d).String() }
核心在两个地方。
一个是创建新类型变量时,要使用传入的变量地址创建新类型变量,以实现将解析结果放到其中,让前端能获取到,二是 Set
方法中实现命令行传入字符串的解析。
逻辑梳理
看完上个小节,基本已经了解如何扩展一个新类型了。本质是是实现 Value
接口。
再看下之前提到的几个变量,分别是存放解析结果的指针、解析命令行输入的 Value
和表示一个选项的 Flag
。对应于 flag.DurationVar
,这个变量的类型分别是 *time.Duration
、durationValue
和 Flag
。
比如有 duration=1h
,大致流程是首先从 os.Args
获取参数,按规则解析出选项名称 duration
,查找是否存在名称为 duration
的 Flag
,如果存在,使用 Flag.Value.Set
解析 1h
,如果不满足 duration
的要求,将给出错误提示。
实现新类型
现在实现文章开头要求的目标。
新类型定义如下:
type stringEnumValue struct {options []stringp *string
}
名为 StringEnumValue
,即字符串枚举。它有 options
和 p
两个成员,options
指定一定范围的值,p
是 string
指针,保存解析结果的变量的地址。
下面定义创建 StringEnumValue
变量的函数 newStringEnumValue
,代码如下:
func newStringEnumValue(val string, p *string, options []string) *StringEnumValue {*option = valreturn &stringEnumValue{options: options, p: p}
}
除了 val
和 p
两个必要的输入外,还有一个 string
切片类型的数,名为 options
,它用于范围的限定。而函数主体,首先设置默认值,然后使用 options
和 p
创建变量返回。
Set
是核心方法,解析命令行传入字符串。代码如下:
func (s *StringEnumValue) Set(v string) error {for _, option := range s.options {if v == option {*(s.p) = vreturn nil}}return fmt.Errorf("must be one of %v", s.options)
}
循环检查输入参数 v
是否满足要求。定义如下:
最后是 String()
方法,
func (s *StringEnumValue) String() string {return *(s.p)
}
返回 p
指针中的值。前面分析实现思路时,Flag
在设置默认值时就调用了它。
使用 StringEnumValue
直接看代码吧。如下:
var origin string
func init() {flag.Var(newStringEnumValue("installed", // 默认值&origin,[]string{"installed", "local", "remote"},),"origin",`the origin of version information, such as installed, local, remote (default: "installed")`,)
}func main() {flag.Parse()fmt.Println(option)
}
重点就是 flag.Var(newStringEnumValue(...),...)
。如果觉得有点啰嗦,希望和其他类型新建过程相同,在这个基础上可以再包装。代码如下:
func StringEnumVar(p *string, name string, options []string, defVal string, usage string) {flag.Var(newStringEnumValue(defVal, p, options), name, usage)
}
编译测试下,结果如下:
$ gvg --origin=any
invalid value "any" for flag -origin: must be one of [installed local remote]
Usage of gvg:-origin valuethe origin of version information, such as installed, local, remote (default installed)
$ gvg --origin=remote
origin remote
总结
本文介绍了如何为 flag 扩展一个类型支持,通过分析源码理清实现思路。最后创建了一个只接收指定范围值 Value。
欢迎关注我的微信公众号。
![](/assets/blank.gif)
: error c2062: 意外的类型“int”_Go 命令行解析 flag 包之扩展新类型相关推荐
- 【Rust】argh:基于 derive 宏且对二进制体积进行优化的命令行解析工具
Derive-based argument parsing optimized for code size and conformance to the Fuchsia commandline too ...
- 代码行统计工具:根据命令行输入的指定目录及文件类型进行统计目录或单个文件的代码行数
#统计指定目录(count_path).指定文件类型文件(file_types)的代码量 import os def count_all_file_code(count_path,file_types ...
- python 命令行 解析模块 optparse、argparse
optparse:https://docs.python.org/zh-cn/3/library/optparse.html argparse :https://docs.python.org/zh- ...
- python命令行解析_python命令行解析函数
sys.argv 在终端运行python 1.py hahah importsysprint(sys.argv) #['1.py', 'hahah'] argparse Python的命令行解析模块, ...
- 一种命令行解析的新思路(Go 语言描述)
简介: 本文通过打破大家对命令行的固有印象,对命令行的概念解构后重新梳理,开发出一种功能强大但使用极为简单的命令行解析方法.这种方法支持任意多的子命令,支持可选和必选参数,对可选参数可提供默认值,支持 ...
- [编程基础] Python命令行解析库argparse学习笔记
Python argparse教程展示了如何使用argparse模块解析Python中的命令行参数. 文章目录 1 使用说明 1.1 Python argparse可选参数 1.2 Python ar ...
- 【Python】Python脚本命令行解析
Python脚本命令行解析 argparse 模块 使用 argparse 模块可以方便的编写出友好的命令行接口.程序定义需要的参数,然后 argparse 将从sys.argv解析出那些参数.arg ...
- linux c 命令行解析 getopt getopt_long optarg optind opterr optopt 简介
目录 getopt 函数 测试代码 getopt_long函数 代码示例 getopt 函数 头文件 #include<unistd.h> 定义函数 int getopt(int argc ...
- python getopt argparse_python OptParse模块和argparse命令行解析的用法详解
https://www.cnblogs.com/wj-1314/p/8974021.html OptParse模块的简单介绍 Python 有两个内建的模块用于处理命令行参数: 一个是 getopt只 ...
最新文章
- 使用VB.NET加快代码开发速度
- JavaScript实现完整的matrix矩阵类(附完整源码)
- 关于sql中的with(nolock)
- 信息学奥赛一本通 1356:计算(calc)
- 5.Java 面试题整理(JDBC ,JDO 方面)
- SAP License:中国集团管控存在的主要问题-已加入点评
- 第5章 见缝插针(《C和C++游戏趣味编程》配套教学视频)
- oh my zsh使用频率前 20 的命令
- [4G5G专题-20]:架构-降低业务延时的移动边缘计算MEC-应用服务的下沉。
- 黑客为什么不攻击支付宝?
- 英特尔hd630驱动_英特尔Iris HD Graphics显卡驱动64位_ intel驱动-PChome下载中心
- 世界头号黑客“米特尼克”对生活的见解自述
- How to create swiping gesture list items for Windows Phone 7
- java中linechart用法_Line Chart
- Java混元功法_陈式太极心意混元 入门功法---太极内功 1
- live555源码分析(七)播放过程
- Spring Security Oauth2 令牌增加额外信息
- 什么是CLI(命令行界面)、GUI(图形用户界面)、Terminal(终端)、Console(控制台)、Shell、TTY
- Linux C 函数指针应用---回调函数
- Sqoop 是什么?Sqoop 有什么特点?
热门文章
- RPC 笔记(01)— RPC概念、调用流程、RPC 与 Restful API 区别
- 垃圾回收 内存管理 python
- pycharm波浪线检查去掉
- 《Attention is All You Need》浅读(简介+代码)
- ERROR: epmd error for host 192: badarg (unknown POSIX error)
- LeetCode简单题之在长度 2N 的数组中找出重复 N 次的元素
- LeetCode简单题之键盘行
- Cuda Stream流 分析
- 2021年大数据HBase(三):HBase数据模型!!!【建议收藏】
- DNC-cs6200 ospfv3