赖新南 da3a70fec8 Update jmespath/go-jmespath version to revision:c2b33e84 hace 6 años
..
.travis.yml 6e81423f22 update dependency (#197) hace 6 años
Gopkg.lock 06fdc4e77f log hace 7 años
Gopkg.toml 6e81423f22 update dependency (#197) hace 6 años
LICENSE 06fdc4e77f log hace 7 años
README.md 6e81423f22 update dependency (#197) hace 6 años
go_above_17.go 06fdc4e77f log hace 7 años
go_above_19.go 06fdc4e77f log hace 7 años
go_below_17.go 6e81423f22 update dependency (#197) hace 6 años
go_below_19.go 06fdc4e77f log hace 7 años
reflect2.go 6e81423f22 update dependency (#197) hace 6 años
reflect2_amd64.s 06fdc4e77f log hace 7 años
reflect2_kind.go 6e81423f22 update dependency (#197) hace 6 años
relfect2_386.s 06fdc4e77f log hace 7 años
relfect2_amd64p32.s 06fdc4e77f log hace 7 años
relfect2_arm.s 06fdc4e77f log hace 7 años
relfect2_arm64.s 06fdc4e77f log hace 7 años
relfect2_mips64x.s 06fdc4e77f log hace 7 años
relfect2_mipsx.s 06fdc4e77f log hace 7 años
relfect2_ppc64x.s 06fdc4e77f log hace 7 años
relfect2_s390x.s 06fdc4e77f log hace 7 años
safe_field.go 6e81423f22 update dependency (#197) hace 6 años
safe_map.go 6e81423f22 update dependency (#197) hace 6 años
safe_slice.go 6e81423f22 update dependency (#197) hace 6 años
safe_struct.go 6e81423f22 update dependency (#197) hace 6 años
safe_type.go 6e81423f22 update dependency (#197) hace 6 años
test.sh da3a70fec8 Update jmespath/go-jmespath version to revision:c2b33e84 hace 6 años
type_map.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_array.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_eface.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_field.go 06fdc4e77f log hace 7 años
unsafe_iface.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_link.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_map.go 06fdc4e77f log hace 7 años
unsafe_ptr.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_slice.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_struct.go 6e81423f22 update dependency (#197) hace 6 años
unsafe_type.go 6e81423f22 update dependency (#197) hace 6 años

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).