golang reflect 反射包

直立猿 · · 471 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

基础类型描述

  • Type Kind

    type Kind uint
    
  • 基础类型常量

    const (
        Invalid Kind = iota
        Bool
        Int
        Int8
        Int16
        Int32
        Int64
        Uint
        Uint8
        Uint16
        Uint32
        Uint64
        Uintptr
        Float32
        Float64
        Complex64
        Complex128
        Array
        Chan
        Func
        Interface
        Map
        Ptr
        Slice
        String
        Struct
        UnsafePointer
    )
    
  • func String 获取类型字符名称

    func (k Kind) String() string
    
    intType := reflect.Int
    typeName := intType.String()
    // >>> int
    

结构体类型描述

  • type StructField 结构体字段信息

    type StructField struct {
      Name    string
        PkgPath string      // 非导出字段包引入地址
        Type      Type      // 字段的类型
        Tag       StructTag // 字段的标签
        Offset    uintptr   // 字段在结构体中的字节偏移量
        Index     []int     // 用于Type.FieldByIndex时的索引切片
        Anonymous bool      // 是否匿名字段
    }
    
    type Man struct{
        name string `json:"name"`
    }
    
    c := Man{"coco"}
    t := reflect.TypeOf()
    s := t.Field(0) // 获取结构体第0位字段信息
    
    fmt.Println(s.Name)
    // >>> name
    fmt.Println(s.PkgPath)
    // >>> main
    fmt.Println(s.Type)
    // >>> string
    
    
  • type StructTag 结构体标签

    type StructTag string
    
  • func(StructTag) Get 获取标签中对应的值

    func (tag StructTag) Get(key string) string
    
    s.Type.Get("json")
    // >>> name
    // Get 的参数指的是标签定义中的类型
    

管道类型描述

  • type ChanDir 管道方向

    type ChanDir int
    
    const (
        RecvDir ChanDir             = 1 << iota // <-chan
        SendDir                                 // chan<-
        BothDir = RecvDir | SendDir             // chan
    )
    
  • func (ChanDir) string 获取管道方向名称

    func (d ChanDir) String() string
    
  • type SelectCase select描述

    type SelectCase struct {
        Dir  SelectDir // case的方向
        Chan Value     // 使用的通道(收/发)
        Send Value     // 用于发送的值
    }
    
  • Select

    func Select(cases []SelectCase) (chosen int, recv Value, recvOK bool)
    

方法类型描述

  • type Method

    type Method struct {
        Name    string
        PkgPath string // 非导出字段包地址
        Type  Type  // 方法类型
        Func  Value // 方法的值
        Index int   // 用于Type.Method的索引
    }
    
    type Man struct {
      name string
    }
    
    func (m *Man) GetName() string {
      return m.name
    }
    
    
    c := Man{"coco"}
    // 应为GetName方法绑定在类型指针上所以这里传入的参数为指针
    // 侧面也证明了结构体方法的绑定及调用方式
    t := reflect.TypeOf(&c)
    mNum := t.NumMethod()
    fmt.Println(mNum)
    // >>> 1
    m := t.Method(0)
    fmt.Println(m.Name)
    // >>> GetName
    
    

类型描述定义

  • type Type 用来描述一个go类型信息

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

类型信息的获取

  • func TypeOf 获取类型信息

    func TypeOf(i interface{}) Type
    
    reflect.TypeOf(10)
    
  • func PtrTo 获取类型的指针类型

      num := 10
      numType := reflect.TypeOf(num)
      fmt.Println(numType.Kind())
      // >>> int
      PType := reflect.PtrTo(numType)
      fmt.Println(PType.Kind())
      // >>> ptr
    
  • func SliceOf 获取类型的切片类型

    func SliceOf(t Type) Type
    
  • func MapOf

    func MapOf(key, elem Type) Type
    
  • func ChanOf

    func ChanOf(dir ChanDir, t Type) Type
    

类型值

  • type Value

    type Value struct {
        // 内含隐藏或非导出字段
    }
    

获取类型值

  • func ValueOf 获取类型的值

    func ValueOf(i interface{}) Value
    
    var d interface{}
    d = 10
    reflect.ValueOf(d)
    
    
  • func Zero 获取类型零值

    func Zero(typ Type) Value
    
    
  • func New 获取类型T的零指指针

    func New(typ Type) Value
    
    
  • func Indirect 返回持有v持有的指针指向的值的Value

    func Indirect(v Value) Value
    
    
  • func MakeSlice 创建一个切片类型Value

    func MakeSlice(typ Type, len, cap int) Value
    
    
  • func MakeMap 创建一个Map类型的Value

    func MakeMap(typ Type) Value
    
    
  • func MakeChan 创建一个Chan类型的Value

    func MakeChan(typ Type, buffer int) Value
    
    
  • func MakeFunc 创建一个func类型的Value

    func MakeFunc(typ Type, fn func(args []Value) (results []Value)) Value
    
    

Value 操作函数

  • func Append 向切片类型Value 添加值

    func Append(s Value, x ...Value) Value
    
    
  • func AppendSlice 合并切片Value

    func AppendSlice(s, t Value) Value
    
    

Value 判断方法

  • func (Value) IsValid 是否持有值

    func (v Value) IsValid() bool
    
    
    var i int
    v := reflect.ValueOf(i)
    fmt.Println(v.IsValid())
    // >>> true
    
    var i interface{}
    v := reflect.ValueOf(i)
    fmt.Println(v.IsValid())
    // >>> false
    
    
  • func (Value) IsNil 是否为nil

    func (v Value) IsNil() bool
    
    
  • func (Value) Kind 获取类型分类

    func (v Value) Kind() Kind
    
    
  • func (Value) Type 获取类型描述

    func (v Value) Type() Type
    
    

Value 转换

  • func (Value) Convert 将v持有的值转换为类型为t的值,并返回该值的Value封装

    func (v Value) Convert(t Type) Value
    
    
  • func (Value) Bool V to Bool

    func (v Value) Bool() bool
    
    
  • func (Value) Int V to Int

    func (v Value) Int() int64
    
    
  • func (Value) Unit V to Unit

    func (v Value) Uint() uint64
    
    
  • func (Vaue) Float V to Float

    func (v Value) Float() float64
    
    
  • func (Value)Complex V to Complex

    func (v Value) Complex() complex128
    
    
  • func (Value) Pointer V to Pointer

    func (v Value) Pointer() uintptr
    
    
  • func (Value) Bytes V to Bytes

    func (v Value) Bytes() []byte
    
    
  • func (Value) String V to String

    func (v Value) String() string
    
    
  • func (Value) InterfaceDate V to interface

    func (v Value) InterfaceData() [2]uintptr
    
    
  • func (Value) Slice V to slice

    func (v Value) Slice(i, j int) Value
    
    

Value 列表类操作方法

  • func (Value) Cap 获取容量

    func (v Value) Cap() int
    
    
  • func (Value) Len 获取长度

    func (v Value) Len() int
    
    
  • func (value) Index 获取指定元素

    func (v Value) Index(i int) Value
    
    

Value 结构类操作方法

  • func (Value) MapIndex 获取指定key 的Value

    func (v Value) MapIndex(key Value) Value
    
    
  • func (Value) MapKeys 获取键值列表

    func (v Value) MapKeys() []Value
    
    
  • func (Value) NumFieId 获取字段为结构体的数量

    func (v Value) NumField() int
    
    
  • func (Value) FieId 获取字段结构体中指定位置的Value

    func (v Value) Field(i int) Value
    
    
  • func (Value) FieIdByIndex

    func (v Value) FieldByIndex(index []int) Value
    
    
  • func (Value) FieIdByName

    func (v Value) FieldByName(name string) Value
    
    
  • func (Value) FieIdByNameFunc

    func (v Value) FieldByNameFunc(match func(string) bool) Value
    
    

Value 函数或方法操作方法


有疑问加站长微信联系(非本文作者)

本文来自:简书

感谢作者:直立猿

查看原文:golang reflect 反射包

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

471 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传