intern

Documentation

Overview

Package intern implements value interning for Cgo sharing.

Index

• func Free(box *Box)
• type Box
  • func Get(gobject unsafe.Pointer, take bool) *Box
  • func TryGet(gobject unsafe.Pointer) *Box
  • func (b *Box) Closures() *closure.Registry
  • func (b *Box) GObject() unsafe.Pointer

Functions

func Free

func Free(box *Box)

Free explicitly frees the box permanently. It must not be resurrected after this.

Deprecated: this function is no longer needed.

Types

type Box

type Box struct {
	// contains filtered or unexported fields
}

Box is an opaque type holding extra data.

func Get

func Get(gobject unsafe.Pointer, take bool) *Box

Get gets the interned box for the given GObject C pointer. If the object is new or unknown, then a new box is made. If the intern box already exists for a given C pointer, then that box is weakly referenced and returned. The box will be reference-counted; the caller must use ShouldFree to unreference it.

func TryGet

func TryGet(gobject unsafe.Pointer) *Box

TryGet gets the Box associated with the GObject or nil if it's gone. The caller must not retain the Box pointer anywhere.

func (*Box) Closures

func (b *Box) Closures() *closure.Registry

Closures returns the closure registry for this Box.

func (*Box) GObject

func (b *Box) GObject() unsafe.Pointer

Object returns Box's C GObject pointer.