unsafeheader

Documentation

Overview

Package unsafeheader contains header declarations copied from Go's runtime.

Index

• func BytesToString(b []byte) string
• func SliceData[T any](slice []T) unsafe.Pointer
• func StringData(str string) unsafe.Pointer
• func StringToBytes(s string) []byte
• func ToRType(t reflect.Type) unsafe.Pointer
• func ToReflectType(rtype unsafe.Pointer) reflect.Type
• type Eface
  • func ToEface(ep *any) Eface
• type Iface
  • func ToIface(t reflect.Type) Iface
• type SliceHeader
• type StringHeader

Functions

func BytesToString

func BytesToString(b []byte) string

func SliceData

func SliceData[T any](slice []T) unsafe.Pointer

SliceData returns a pointer to the underlying array of the argument slice.

• If len(slice) == 0, it returns nil.
• Otherwise, it returns the underlying pointer.

func StringData

func StringData(str string) unsafe.Pointer

StringData returns a pointer to the underlying bytes of str.

• If str == "", it returns nil.
• Otherwise, it returns the underlying pointer.

func StringToBytes

func StringToBytes(s string) []byte

func ToRType

func ToRType(t reflect.Type) unsafe.Pointer

ToRType gets the underlying [*reflect.rtype] from a reflect.Type.

func ToReflectType

func ToReflectType(rtype unsafe.Pointer) reflect.Type

ToReflectType convert an [*reflect.rtype] pointer to a reflect.Type value. It is the reverse operation of ToRType.

Types

type Eface

type Eface struct {
	RType unsafe.Pointer // *rtype
	Word  unsafe.Pointer // data pointer
}

Eface is the header for an empty interface{} value. It is a copy type of [runtime.eface].

func ToEface

func ToEface(ep *any) Eface

ToEface casts an empty interface{} value to an Eface value.

type Iface

type Iface struct {
	Tab  unsafe.Pointer // *itab
	Data unsafe.Pointer
}

Iface is the header of a non-empty interface value. It is a copy type of [runtime.iface].

func ToIface

func ToIface(t reflect.Type) Iface

ToIface casts a reflect.Type to an Iface value.

type SliceHeader

type SliceHeader struct {
	Data unsafe.Pointer
	Len  int
	Cap  int
}

SliceHeader is the runtime representation of a slice.

Unlike reflect.SliceHeader, its Data field is sufficient to guarantee the data it references will not be garbage collected.

type StringHeader

type StringHeader struct {
	Data unsafe.Pointer
	Len  int
}

StringHeader is the runtime representation of a string.

Unlike reflect.StringHeader, its Data field is sufficient to guarantee the data it references will not be garbage collected.