rtutil

README

go-rtutil

Go runtime / reflect utilities (hacks). You should not use these without deep understanding! (that's probably a bold claim about my own undstanding...)

So yeah, here be dragons and all that.

Documentation

Index

• func GetRuntimeType(t reflect.Type) unsafe.Pointer
• func GetStructFields(v interface{}) []reflect.StructField
• func GetStructFieldsByType(t reflect.Type) []reflect.StructField
• func IsValidStructTag(tag string) bool
• type Eface
  • func ToEface(v interface{}) *Eface

Functions

func GetRuntimeType

func GetRuntimeType(t reflect.Type) unsafe.Pointer

GetRuntimeType will fetch a pointer for the runtime._type value of the originating object this reflect.Type represents. This is possible because the reflect package returns the value of an interface{}'s Eface.Type cast as their copy of runtime._type. So the Eface.Data value for this reflected type will be the underlying runtime type this was from.

func GetStructFields

func GetStructFields(v interface{}) []reflect.StructField

GetStructFields will fetch struct field information for any struct-type 'v', caching the results between consecutive calls. For this reason you should treat returned fields as READ-ONLY. This method is useful if you expect to be regularly reflecting and iterating a type's struct fields.

func GetStructFieldsByType

func GetStructFieldsByType(t reflect.Type) []reflect.StructField

GetStructFieldsByType will fetch struct field information for any reflected struct-type 't', caching the results between consecutive calls. For this reason you should treat returned fields as READ-ONLY. This method is useful if you expect to be regularly reflecting and iterating a type's struct fields.

func IsValidStructTag

func IsValidStructTag(tag string) bool

IsValidStructTag will return whether tag value is valid for use, i.e. not empty or marked as ignore '-'.

Types

type Eface

type Eface struct {
	// Type is a pointer to the runtime._type.
	Type unsafe.Pointer

	// Value is a pointer to the actual data.
	Value unsafe.Pointer
}

Eface (empty interface) is the header for an interface{} value.

func ToEface

func ToEface(v interface{}) *Eface

ToEface will return the Eface header for given interface{} value.