因为各种移植性的考虑和功能性的考虑,我们有时需要在Go中调用C库或C++库。C库的调用很简单,使用cgo就可以实现,但是使用c++库,由于Golang还是基于c的,所以还需要在c++库上再包裹一层c的中间层。
I’ve created the following example based on Scott Wales’ answer. I’ve tested it in macOS High Sierra 10.13.3 running go version go1.10 darwin/amd64.
(1) Code for library.hpp, the C++ API we aim to call.
#pragma once
class Foo {
public:
Foo(int value);
~Foo();
int value() const;
private:
int m_value;
};
(2) Code for library.cpp, the C++ implementation.
#include “library.hpp”
#include
Foo::Foo(int value) : m_value(value) {
std::cout << “[c++] Foo::Foo(“ << m_value << “)” << std::endl;
}
Foo::Foo() { std::cout << “[c++] Foo::Foo(“ << m_value << “)” << std::endl; }
int Foo::value() const {
std::cout << “[c++] Foo::value() is “ << m_value << std::endl;
return m_value;
}
(3) Code for library-bridge.h the bridge needed to expose a C API implemented in C++ so that go can use it.
#pragma once
#ifdef __cplusplus
extern “C” {
#endif
void* LIB_NewFoo(int value);
void LIB_DestroyFoo(void* foo);
int LIB_FooValue(void* foo);
#ifdef __cplusplus
} // extern “C”
#endif
(4) Code for library-bridge.cpp, the implementation of the bridge.
#include
#include “library-bridge.h”
#include “library.hpp”
void* LIB_NewFoo(int value) {
std::cout << “[c++ bridge] LIB_NewFoo(“ << value << “)” << std::endl;
auto foo = new Foo(value);
std::cout << “[c++ bridge] LIB_NewFoo(“ << value << “) will return pointer “
<< foo << std::endl;
return foo;
}
// Utility function local to the bridge’s implementation
Foo* AsFoo(void* foo) { return reinterpret_cast<Foo*>(foo); }
void LIB_DestroyFoo(void* foo) {
std::cout << “[c++ bridge] LIB_DestroyFoo(“ << foo << “)” << std::endl;
AsFoo(foo)->~Foo();
}
int LIB_FooValue(void* foo) {
std::cout << “[c++ bridge] LIB_FooValue(“ << foo << “)” << std::endl;
return AsFoo(foo)->value();
}
(5) Finally, library.go, the go program calling the C++ API.
package main
// #cgo LDFLAGS: -L. -llibrary
// #include “library-bridge.h”
import “C”
import “unsafe”
import “fmt”
type Foo struct {
ptr unsafe.Pointer
}
func NewFoo(value int) Foo {
var foo Foo
foo.ptr = C.LIB_NewFoo(C.int(value))
return foo
}
func (foo Foo) Free() {
C.LIB_DestroyFoo(foo.ptr)
}
func (foo Foo) value() int {
return int(C.LIB_FooValue(foo.ptr))
}
func main() {
foo := NewFoo(42)
defer foo.Free() // The Go analog to C++’s RAII
fmt.Println(“[go]”, foo.value())
}
Using the following Makefile
liblibrary.so: library.cpp library-bridge.cpp
clang++ -o liblibrary.so library.cpp library-bridge.cpp
-std=c++17 -O3 -Wall -Wextra -fPIC -shared
I can run the example program as follows:
$ make
clang++ -o liblibrary.so library.cpp library-bridge.cpp
-std=c++17 -O3 -Wall -Wextra -fPIC -shared
$ go run library.go
[c++ bridge] LIB_NewFoo(42)
[c++] Foo::Foo(42)
[c++ bridge] LIB_NewFoo(42) will return pointer 0x42002e0
[c++ bridge] LIB_FooValue(0x42002e0)
[c++] Foo::value() is 42
[go] 42
[c++ bridge] LIB_DestroyFoo(0x42002e0)
[c++] Foo::~Foo(42)
Important
The comments above import “C” in the go program are NOT OPTIONAL. You must put them exactly as shown so that cgo knows which header and library to load, in this case:
// #cgo LDFLAGS: -L. -llibrary
// #include “library-bridge.h”
import “C”
Link to GitHub repo with the full example.