gohacks

Documentation

Overview

Package gohacks contains utilities for subverting the Go compiler.

Index

• func ImmutableBytesFromString(s string) []byte
• func Memmove(to, from unsafe.Pointer, n uintptr)
• func Nanotime() int64
• func Noescape(p unsafe.Pointer) unsafe.Pointer
• func Slice[T any](ptr *T, length int) []T
• func StringFromImmutableBytes(bs []byte) string

Functions

func ImmutableBytesFromString

func ImmutableBytesFromString(s string) []byte

ImmutableBytesFromString is equivalent to []byte(s), except that it uses the same memory backing s instead of making a heap-allocated copy. This is only valid if the returned slice is never mutated.

func Memmove

func Memmove(to, from unsafe.Pointer, n uintptr)

Memmove is runtime.memmove, exported for SeqAtomicLoad/SeqAtomicTryLoad<T>.

func Nanotime

func Nanotime() int64

Nanotime is runtime.nanotime.

func Noescape

func Noescape(p unsafe.Pointer) unsafe.Pointer

Noescape hides a pointer from escape analysis. Noescape is the identity function but escape analysis doesn't think the output depends on the input. Noescape is inlined and currently compiles down to zero instructions. USE CAREFULLY!

Noescape is copy/pasted from Go's runtime/stubs.go:noescape(), and is valid as of Go 1.20. It is possible that this approach stops working in future versions of the toolchain, at which point `p` may still escape.

func Slice

func Slice[T any](ptr *T, length int) []T

Slice returns a slice whose underlying array starts at ptr an which length and capacity are len.

Slice is a wrapper around unsafe.Slice. Prefer to use unsafe.Slice directly if possible.

func StringFromImmutableBytes

func StringFromImmutableBytes(bs []byte) string

StringFromImmutableBytes is equivalent to string(bs), except that it uses the same memory backing bs instead of making a heap-allocated copy. This is only valid if bs is never mutated after StringFromImmutableBytes returns.