iwita b9152718d2 new version 5 jaren geleden
..
.gitignore b9152718d2 new version 5 jaren geleden
.travis.yml b9152718d2 new version 5 jaren geleden
BUILD b9152718d2 new version 5 jaren geleden
Gopkg.lock b9152718d2 new version 5 jaren geleden
Gopkg.toml b9152718d2 new version 5 jaren geleden
LICENSE b9152718d2 new version 5 jaren geleden
README.md b9152718d2 new version 5 jaren geleden
go_above_17.go b9152718d2 new version 5 jaren geleden
go_above_19.go b9152718d2 new version 5 jaren geleden
go_below_17.go b9152718d2 new version 5 jaren geleden
go_below_19.go b9152718d2 new version 5 jaren geleden
reflect2.go b9152718d2 new version 5 jaren geleden
reflect2_amd64.s b9152718d2 new version 5 jaren geleden
reflect2_kind.go b9152718d2 new version 5 jaren geleden
relfect2_386.s b9152718d2 new version 5 jaren geleden
relfect2_amd64p32.s b9152718d2 new version 5 jaren geleden
relfect2_arm.s b9152718d2 new version 5 jaren geleden
relfect2_arm64.s b9152718d2 new version 5 jaren geleden
relfect2_mips64x.s b9152718d2 new version 5 jaren geleden
relfect2_mipsx.s b9152718d2 new version 5 jaren geleden
relfect2_ppc64x.s b9152718d2 new version 5 jaren geleden
relfect2_s390x.s b9152718d2 new version 5 jaren geleden
safe_field.go b9152718d2 new version 5 jaren geleden
safe_map.go b9152718d2 new version 5 jaren geleden
safe_slice.go b9152718d2 new version 5 jaren geleden
safe_struct.go b9152718d2 new version 5 jaren geleden
safe_type.go b9152718d2 new version 5 jaren geleden
test.sh b9152718d2 new version 5 jaren geleden
type_map.go b9152718d2 new version 5 jaren geleden
unsafe_array.go b9152718d2 new version 5 jaren geleden
unsafe_eface.go b9152718d2 new version 5 jaren geleden
unsafe_field.go b9152718d2 new version 5 jaren geleden
unsafe_iface.go b9152718d2 new version 5 jaren geleden
unsafe_link.go b9152718d2 new version 5 jaren geleden
unsafe_map.go b9152718d2 new version 5 jaren geleden
unsafe_ptr.go b9152718d2 new version 5 jaren geleden
unsafe_slice.go b9152718d2 new version 5 jaren geleden
unsafe_struct.go b9152718d2 new version 5 jaren geleden
unsafe_type.go b9152718d2 new version 5 jaren geleden

README.md

reflect2

Sourcegraph GoDoc Build Status codecov rcard License

reflect api that avoids runtime reflect.Value cost

  • reflect get/set interface{}, with type checking
  • reflect get/set unsafe.Pointer, without type checking
  • reflect2.TypeByName works like Class.forName found in java

json-iterator use this package to save runtime dispatching cost. This package is designed for low level libraries to optimize reflection performance. General application should still use reflect standard library.

reflect2.TypeByName

// given package is github.com/your/awesome-package
type MyStruct struct {
	// ...
}

// will return the type
reflect2.TypeByName("awesome-package.MyStruct")
// however, if the type has not been used
// it will be eliminated by compiler, so we can not get it in runtime

reflect2 get/set interface{}

valType := reflect2.TypeOf(1)
i := 1
j := 10
valType.Set(&i, &j)
// i will be 10

to get set type, always use its pointer *type

reflect2 get/set unsafe.Pointer

valType := reflect2.TypeOf(1)
i := 1
j := 10
valType.UnsafeSet(unsafe.Pointer(&i), unsafe.Pointer(&j))
// i will be 10

to get set type, always use its pointer *type

benchmark

Benchmark is not necessary for this package. It does nothing actually. As it is just a thin wrapper to make go runtime public. Both reflect2 and reflect call same function provided by runtime package exposed by go language.

unsafe safety

Instead of casting []byte to sliceHeader in your application using unsafe. We can use reflect2 instead. This way, if sliceHeader changes in the future, only reflect2 need to be upgraded.

reflect2 tries its best to keep the implementation same as reflect (by testing).