标准库 reflect 翻译
2019-02-04 本文已影响0人
Asphalt7
import "reflect"
reflect 包实现了运行时反射,允许程序操作任意类型的对象。
典型用法是用静态类型 interface{} 保存一个值,通过调用 TypeOf 获取其动态类型信息,该函数返回一个 Type 类型值。调用 ValueOf 函数,返回一个 Value 类型值,该值代表运行时的数据。Zero 接收一个 Type 类型参数,并返回一个代表该类型零值的 Value 类型值。
一、类结构
type Kind uint
Kind 是 uint 的别名,代表 Type 类型值表示的具体分类。零值表示非法分类。
type Type
type Type interface {
Kind() Kind // Kind 返回该接口的具体分类。
Name() string // Name 返回该类型在自身包内的类型名,如果是未命名类型,会返回""
PkgPath() string // PkgPath 返回类型的包路径,即明确指定包的 import 路径,如"encoding/base64"。如果类型为内建类型(string, error) 或未命名类型 (*T, struct{}, []int) , 会返回" "
String() string // 返回类型的字符串表示。该字符串可能会使用短包名(如用base64代替"encoding/base64")。也不保证每个类型的字符串表示不同。如果要比较两个类型是否相等,请直接使用 Type 类型比较。
Size() uintptr // 返回要保存一个该类型的值需要多少字节;类似 unsafe.Sizeof
Align() int // 返回当从内存中申请一个该类型值时,会对齐的字节数。
FieldAlign() int // 返回当该类型作为结构体的字段时,会对齐的字节数。
Implements(u Type) bool // 返回该类型实现了u代表的接口,会返回真。
AssignableTo(u Type) bool // 如果该类型的值,可以直接赋值给u代表的类型,返回真。
ConvertibleTo(u Type) bool // 如果该类型的值,可以转换为u代表的类型,返回真。
Bits() int // 返回该类型的字位数,如果该类型的Kind不是Int、Uint、Float或Complex,会panic。
Len() int // 返回array类型的长度,如非数组类型将会panic。
Elem() Type // 返回该类型的元素类型,如果该类型的Kind不是Array、Chan、Map、Ptr或Slice,将会panic。
Key() Type // 返回map类型的键的类型。如非映射类型将会panic。
ChanDir() ChanDir // 返回一个channel类型的方向,如非通道类型将会panic。
NumField() int // 返回struct类型的字段数(匿名字段算作一个字段),如非结构体类型将panic。
Field(i int) StructField // 返回struct类型的第i个字段的类型,如非结构体或者 i 不在 [0, NumField()] 内将会panic。
FieldByIndex(index []int) StructField // 返回索引序列指定的嵌套字段的类型。等价于用索引中每个值链式调用本方法,如非结构体将会panic。
FieldByName(name string) (StructField, bool) // 返回该类型名为name的字段(会查找匿名字段及其子字段),如非结构体将会panic。
FieldByNameFunc(match func(string) bool) (StructField, bool) // 返回该类型第一个字段名满足函数 match 的字段,布尔值说明是否找到,如非结构体将会panic。
IsVariadic() bool // 如果函数类型的最后一个输入参数是" ... "形式的参数,IsVariadic返回真。如果这样,t.In(t.NumIn() - 1) 返回参数的隐式的实际类型(声明类型的切片)。如非函数类型将panic。
NumIn() int // 返回func类型的参数个数,如果不是函数,将会panic。
Out(i int) int // 返回func类型的第1个返回值的类型,如非函数或者i不在[0, NumOut()] 内将会panic。
NumMethod() int // 返回该类型的方法集中方法的数据。匿名字段的方法,会被计算;主体类型的方法,会屏蔽匿名字段的同名方法;匿名字段导致的歧义方法会滤除。
Method(int) Method // 返回该类型方法集中的第i个方法,i不在[0, NumMethod()] 范围内时,将导致 panic 。对非接口类型T或*T,返回值的Type字段和Func字段描述方法的未绑定函数状态对接口类型,返回值的Type字段描述方法的签名,Func字段为nil。
MethodByName(string) (Method, bool) // 根据方法名返回该类型方法集中的方法,使用一个布尔值说明是否发现该方法。对非接口类型T或*T,返回值的Type字段和Func字段描述方法的未绑定函数状态。对接口类型,返回值的Type字段描述方法的签名,Func字段为nil
}