浅谈go中cgo的几种使用方式

 更新时间:2022年03月24日 09:51:16   作者:Yuan_sr  
本文主要介绍了浅谈go中cgo的几种使用方式,文中根据实例编码详细介绍的十分详尽,具有一定的参考价值,感兴趣的小伙伴们可以参考一下

最简单的CGO程序

//cgo.go
package main

import "C"

func main(){
    println("hello cgo")
}

上述代码是一个完整的CGO程序,通过import "C"语句启动了CGO特性,go build命令会在编译和链接阶段启动gcc编译器

源码方式调用C函数

cgoTest.h

void SayHello(const char* s);

cgoTest.c

#include <stdio.h>
#include "cgoTest.h"

void SayHello(const char* s) {
    puts(s);
}

main.go

package main

/*
#include <cgoTest.h>
 */
import "C"

func main(){
    C.SayHello(C.CString("Hello world\n"))
}

上述.c文件也可以是.cpp文件,前提是编译时需要g++

cgoTest.cpp

#include <iostream>

extern "C" {
    #include "cgo01.h"
}

void SayHello(const char* s) {
    std::cout << s;
}

上述.c和.cpp的不同实现都实现了SayHello函数,说明解放了函数的实现者,那如果是这种情况,可不可以使用go实现SayHello函数呢?

答案是可以的,这种技术也称为面向C语言接口(.h中的接口声明)的编程技术,该技术不仅仅可以解放函数的实现者,同时也可以简化函数的使用者。

cgoTest.go

package main

import "C"

import "fmt"

//export SayHello
func SayHello(s *C.char){
    fmt.Print(C.GoString(s))  //注意:这里是C.GoString
}

注意:上述main.go文件在使用C函数CString后在程序退出前没有释放C.CString创建的字符串会导致内存泄漏,但是对于这个小程序来说,这样是没有问题的,因为程序推出后操作系统会自动回收程序的所有资源

改进后的main.go代码

package main

/*
#include <cgoTest.h>
#include <stdlib.h>
 */
import "C"
import "unsafe"

func main(){
    cs := C.CString("CPP Hello world\n")
    C.SayHello(cs)
    C.free(unsafe.Pointer(cs))
}

当然也有其他方法可以避免这种麻烦的情况出现,而且只需要一个go文件就可以实现面向C语言的编程

main.go (只有这一个文件)

//+build go1.10
package main

//void SayHello(_GoString_ s); //Go1.10中CGO新增的预定义C语言类型,用来表示Go语言字符串
import "C"
import "fmt"

//export SayHello
func SayHello(s string){ //注意这里变量类型为Go 中的string
    fmt.Print(s)
}
func main(){
    C.SayHello("Hello CGO\n")
}

上面代码执行时先从Go语言的main函数开始,到CGO自动生成的C语言版本SayHello桥接函数,最后到Go语言环境的SayHello函数,是不是有一种合久必分、分久必合的感觉,这也是CGO编程的精华所在。

内部机制

如果在一个go文件中出现了import "C" 指令则表示将调用cgo命令生成的对应的中间文件,下图是cgo生成的中间文件的示意图:

在保证go build 没问题的情况下执行如下命令就可以生成中间文件

go tool cgo main.go

生成的中间文件在_obj目录下

为了在C语言中使用Go语言定义的函数,我们需要将Go代码编译为一个C静态库

go build -buildmode=c-archive -o SayHello.a  cgoTest.go

如果没有错误的话,会生成一个SayHello.a静态库和SayHello.h头文件

既然提到了静态库的生成,顺便也说一下Go生成C动态库

go build -buildmode=c-shared -o SayHello.so cgoTest.go

编译和链接参数

编译和链接参数是每一个C/C++程序员需要经常面对的问题。构建每一个C/C++应用均需要经过编译和链接两个步骤,CGO也是如此

编译参数:CFLAGS/CPPFLAGS/CXXFLAGS

编译参数主要是头文件的检索路径,预定义的宏等参数。理论上来说C和C++是完全独立的两个编程语言,它们可以有着自己独立的编译参数。 但是因为C++语言对C语言做了深度兼容,甚至可以将C++理解为C语言的超集,因此C和C++语言之间又会共享很多编译参数。 因此CGO提供了CFLAGS/CPPFLAGS/CXXFLAGS三种参数,其中CFLAGS对应C语言编译参数(以.c后缀名)、 CPPFLAGS对应C/C++ 代码编译参数(.c,.cc,.cpp,.cxx)、CXXFLAGS对应纯C++编译参数(.cc,.cpp,*.cxx)

链接参数:LDFLAGS

链接参数主要包含要链接库的检索目录和要链接库的名字。因为历史遗留问题,链接库不支持相对路径,我们必须为链接库指定绝对路径。 cgo 中的 ${SRCDIR} 为当前目录的绝对路径。经过编译后的C和C++目标文件格式是一样的,因此LDFLAGS对应C/C++共同的链接参数

CGO在使用C/C++资源的时候一般有三种形式:直接使用源码;链接静态库;链接动态库。直接使用源码就是在import "C"之前的注释部分包含C代码,或者在当前包中包含C/C++源文件。链接静态库和动态库的方式比较类似,都是通过在LDFLAGS选项指定要链接的库方式链接

通过静态库的方式调用C函数

如果CGO中引入的C/C++资源有代码而且代码规模也比较小,直接使用源码是最理想的方式,但很多时候我们并没有源代码,或者从C/C++源代码开始构建的过程异常复杂,这种时候使用C静态库也是一个不错的选择。静态库因为是静态链接,最终的目标程序并不会产生额外的运行时依赖,也不会出现动态库特有的跨运行时资源管理的错误。不过静态库对链接阶段会有一定要求:静态库一般包含了全部的代码,里面会有大量的符号,如果不同静态库之间出现了符号冲突则会导致链接的失败

假设dirname 下有filename.c文件和filename.h文件,则生成静态库的命令为

$ cd ./dirname
$ gcc -c -o filename.o filename.c
$ ar rcs libfilename.a filename.o

使用静态库中的C函数

package main

//#cgo CFLAGS: -I./dirname
//#cgo LDFLAGS: -L${SRCDIR}/dirname -lfilename
//
//#include "filename.h"
import "C"
import "fmt"

func main() {
    fmt.Println(C.filename_func())
}

通过动态库的方式调用C函数

动态库出现的初衷是对于相同的库,多个进程可以共享同一个,以节省内存和磁盘资源。但是在磁盘和内存已经白菜价的今天,这两个作用已经显得微不足道了,那么除此之外动态库还有哪些存在的价值呢?从库开发角度来说,动态库可以隔离不同动态库之间的关系,减少链接时出现符号冲突的风险。而且对于windows等平台,动态库是跨越VC和GCC不同编译器平台的唯一的可行方式

动态库的生成

gcc -shared -o libfinename.so filename.c

对于CGO 来说,使用动态库和静态库是一样的

package main

//#cgo CFLAGS: -I./dirname
//#cgo LDFLAGS: -L${SRCDIR}/dirname -lfilename
//
//#include "filename.h"
import "C"
import "fmt"

func main() {
    fmt.Println(C.filename_func())
}

到此这篇关于浅谈go中cgo的几种使用方式的文章就介绍到这了,更多相关go cgo使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 使用go语言实现Redis持久化的示例代码

    使用go语言实现Redis持久化的示例代码

    redis 是一个内存数据库,如果你把进程杀掉,那么里面存储的数据都会消失,那么这篇文章就是来解决 redis 持久化的问题,本文给大家介绍了使用go语言实现Redis持久化,需要的朋友可以参考下
    2024-07-07
  • go语言中的指针自动解引用

    go语言中的指针自动解引用

    Go语言中,编译器会自动解引用指针来访问字段,自动解引用使得使用指针访问结构体字段和方法变得更加直观,降低了编程错误的风险,并使代码更易于理解和维护
    2024-10-10
  • Go语言里切片slice的用法介绍

    Go语言里切片slice的用法介绍

    这篇文章介绍了Go语言里切片slice的用法,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-07-07
  • golang操作连接数据库实现mysql事务示例

    golang操作连接数据库实现mysql事务示例

    这篇文章主要为大家介绍了golang操作连接数据库实现mysql事务示例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步早日升职加薪
    2022-04-04
  • Golang中实现数据脱敏处理的go-mask包分享

    Golang中实现数据脱敏处理的go-mask包分享

    这篇文章主要是来和大家分享一个在输出中对敏感数据进行脱敏的工作包:go-mask,可以将敏感信息输出的时候替换成星号或其他字符,感兴趣的小编可以跟随小编一起了解下
    2023-05-05
  • golang gorm模型结构体的定义示例

    golang gorm模型结构体的定义示例

    这篇文章主要为大家介绍了golang gorm模型结构体的定义示例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步早日升职加薪
    2022-04-04
  • Go语言读取txt文档的操作方法

    Go语言读取txt文档的操作方法

    Go语言提供了很多文件操作的支持,在不同场景下,有对应的处理方式,本节我们来介绍一下Go语言读取txt文档的相关知识,感兴趣的朋友跟随小编一起看看吧
    2022-01-01
  • 在goland中读取tpl文件的图文操作

    在goland中读取tpl文件的图文操作

    这篇文章主要介绍了在goland中读取tpl文件的图文操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • 解决Golang time.Parse和time.Format的时区问题

    解决Golang time.Parse和time.Format的时区问题

    这篇文章主要介绍了解决Golang time.Parse和time.Format的时区问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-04-04
  • golang 使用time包获取时间戳与日期格式化操作

    golang 使用time包获取时间戳与日期格式化操作

    这篇文章主要介绍了golang 使用time包获取时间戳与日期格式化操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12

最新评论