从 C 代码调用 Go 函数：一份详细教程

package foo

// extern int goCallbackHandler(int, int);
//
// static int doAdd(int a, int b) {
//     return goCallbackHandler(a, b);
// }
import "C"

//export goCallbackHandler
func goCallbackHandler(a, b C.int) C.int {
    return a + b
}

// MyAdd 是一个公共函数，可以从包外部调用。
// 它将参数转发到 C.doAdd()，后者又将它们转发回
// goCallbackHandler()。这个函数执行加法运算并返回结果。
func MyAdd(a, b int) int {
   return int( C.doAdd( C.int(a), C.int(b)) )
}

foo.MyAdd(a, b) ->
  C.doAdd(a, b) ->
    C.goCallbackHandler(a, b) ->
      foo.goCallbackHandler(a, b)

type ProgressHandler func(current, total uint64, userdata interface{}) int

package foo

// #include <somelib.h>
// extern int goProgressCB(uint64_t current, uint64_t total, void* userdata);
//
// static int goGetFiles(some_t* handle, void* userdata) {
//    return somelib_get_files(handle, goProgressCB, userdata);
// }
import "C"
import "unsafe"

// ProgressHandler 定义用户提供的进度处理函数的签名
type ProgressHandler func(current, total uint64, userdata interface{}) int

// progressRequest 是一个内部类型，用于封装用户的回调函数和用户数据。
// 实际上，我们将把这个类型的实例发送到 C 代码。
type progressRequest struct {
   f ProgressHandler  // 用户的函数指针
   d interface{}      // 用户的用户数据
}

//export goProgressCB
func goProgressCB(current, total C.uint64_t, userdata unsafe.Pointer) C.int {
    // 这是一个从 C 代码（通过耗时的 C.somelib_get_files() 函数）调用的函数。
    // userdata 值包含 *progressRequest 的实例。我们解包它并使用它的值来调用
    // 用户提供的实际函数。
    req := (*progressRequest)(userdata)

    // 使用我们的参数和用户的用户数据值调用 req.f。
    return C.int( req.f( uint64(current), uint64(total), req.d ) )
}

// GetFiles 是一个公共函数，由用户调用，
// 它接收 C 库需要的句柄、函数指针和可选的用户定义的数据结构。
func GetFiles(h *Handle, pf ProgressHandler, userdata interface{}) int {
   // 我们不直接调用外部 C 库，而是调用我们的 C 包装器。
   // 我们将句柄和 progressRequest 的实例传递给它。

   req := unsafe.Pointer(&progressRequest{ pf, userdata })
   return int(C.goGetFiles( (*C.some_t)(h), req ))
}

package main

import (
    "foo"
    "fmt"
)

func main() {
    handle := SomeInitStuff()

    // 调用 GetFiles。将我们的进度处理函数和一些
    // 任意用户数据（也可以是 nil）传递给它。
    ret := foo.GetFiles( handle, myProgress, "Callbacks rock!" )

    ....
}

// myProgress 是我们的进度处理函数。执行一些有用的操作，例如显示
// 进度百分比。
func myProgress(current, total uint64, userdata interface{}) int {
    fc := float64(current)
    ft := float64(total) * 0.01

    // 打印我们完成了多少。
    // 例如：500 / 1000 (50.00%)
    // 为了安全起见，在它前面加上我们的用户数据值，我们
    // 将其作为 "Callbacks rock!" 提供。
    fmt.Printf("%s: %d / %d (%3.2f%%)\n", userdata.(string), current, total, fc / ft)
    return 0
}

foo.GetFiles(....) ->
  C.goGetFiles(...) ->
    C.somelib_get_files(..) ->
      C.goProgressCB(...) ->
        foo.goProgressCB(...) ->
           main.myProgress(...)