dylib

README

简介

dylib是从govcl的api包中分离出来，可以方便其它使用。 dylib实现现了一个通用的共享库调用，可以在windows、linux、macOS下不需要任何改变实现通用。 Window下使用syscall.NewLazyDLL加载dll，linux与macOS下使用dlopen加载，然后使用dlsym来获取, 通过封装，使用接口与Windows下的一模一样，如此达到通用，最多实现12个参数的过程。

在被调用的共享库中如果导出了“MySyscall”函数，则会使用此函数来call， 一般导出此函数的目的是为了在共享库中捕获异常，不然一但共享库中出现异常 程序就挂了。

使用方法

import "gitee.com/ying32/govcl/vcl/dylib"

var (
    lib = dylib.NewLazyDLL("xxx.dll") // 或者 dylib.NewLazyDLL("xxx.so") 或者 dylib.NewLazyDLL("xxx.dylib")
    _Func1 = lib.NewProc("Func1") 
)

func Func1(a1, a2 int) int {
    r, _, _ := _Func1.Call(uintptr(a1), uintptr(a2))
    return int(r)
}

需要特别注意的事情

• 1、不要在共享库中返回float类的，不然会被go强转，如需使用可选择使用参数指针传递。
• 2、在参数或者返回值类型中需要注意： 在x86库中应该尽量避免直接返回或者使用size>=8的类型，如需使用最好选择参数指针替代，以保持x86跟x64一致性。

Documentation

Index

• type LazyDLL
  • func NewLazyDLL(name string) *LazyDLL
  • func (l *LazyDLL) Close()
  • func (l *LazyDLL) Load() error
  • func (l *LazyDLL) NewProc(name string) *LazyProc
• type LazyProc
  • func (p *LazyProc) Addr() uintptr
  • func (p *LazyProc) Call(a ...uintptr) (uintptr, uintptr, error)
  • func (p *LazyProc) CallOriginal(a ...uintptr) (r1, r2 uintptr, lastErr error)
  • func (p *LazyProc) Find() error

Types

type LazyDLL

type LazyDLL struct {
	Name string
	// contains filtered or unexported fields
}

func NewLazyDLL

func NewLazyDLL(name string) *LazyDLL

func (*LazyDLL) Close

func (l *LazyDLL) Close()

func (*LazyDLL) Load

func (l *LazyDLL) Load() error

func (*LazyDLL) NewProc

func (l *LazyDLL) NewProc(name string) *LazyProc

type LazyProc

type LazyProc struct {
	Name string
	// contains filtered or unexported fields
}

func (*LazyProc) Addr

func (p *LazyProc) Addr() uintptr

func (*LazyProc) Call

func (p *LazyProc) Call(a ...uintptr) (uintptr, uintptr, error)

func (*LazyProc) CallOriginal

func (p *LazyProc) CallOriginal(a ...uintptr) (r1, r2 uintptr, lastErr error)

func (*LazyProc) Find

func (p *LazyProc) Find() error