gohacks

Documentation

Overview

Package gohacks contains utilities for subverting the Go compiler.

Index

• func ImmutableBytesFromString(s string) []byte
• func Noescape(p unsafe.Pointer) unsafe.Pointer
• 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 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().)

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.