标准库 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
}

type Value

上一篇下一篇

猜你喜欢

热点阅读