cgo

README

Copy from go 1.17.2 runtime/cgo. In order to be compatible with lower versions

Documentation

Index

• type Handle
  • func NewHandle(v interface{}) Handle
  • func (h Handle) Delete()
  • func (h Handle) Pointer() unsafe.Pointer
  • func (h Handle) Value() interface{}

Types

type Handle

type Handle uintptr

func NewHandle

func NewHandle(v interface{}) Handle

NewHandle returns a handle for a given value.

The handle is valid until the program calls Delete on it. The handle uses resources, and this package assumes that C code may hold on to the handle, so a program must explicitly call Delete when the handle is no longer needed.

The intended use is to pass the returned handle to C code, which passes it back to Go, which calls Value.

func (Handle) Delete

func (h Handle) Delete()

Delete invalidates a handle. This method should only be called once the program no longer needs to pass the handle to C and the C code no longer has a copy of the handle value.

The method panics if the handle is invalid.

func (Handle) Pointer

func (h Handle) Pointer() unsafe.Pointer

func (Handle) Value

func (h Handle) Value() interface{}

Value returns the associated Go value for a valid handle.

The method panics if the handle is invalid.