Goメモ-511 (cgoメモ-07)(C.CBytes)([]byteをCのバイト列に)

概要

以下、自分用のメモです。

今回から複数回に渡って cgo についてメモしていこうと思います。

cgo は、文字通りGoからCにアクセスすることが出来るようになるものなのですが、とても便利な反面、結構クセが強いのでメモでも残しておかないとすぐ頭から消えてしまいそうだなって思いました。

Cgo is not Go

という格言があったりするので、Go界隈で標準で推奨されていない技術かもしれません。が、実務ではC言語で作成されたライブラリなどは山のようにあります。んで、プロジェクトの方針でGoで作り直すことも出来ない場合も多々あります。そのような場合に非常に便利です。

これからのサンプルは以下のリポジトリにアップしてありますので、良ければご参考ください。

github.com

今回は cgo で利用する C.CBytes について。

cgo では、import "C" をすることによって、C言語側の型が使えるようになります。

C.CBytes()は、GoのバイトスライスをC側のバイト列に変換します。戻り値はunsafe.Pointerとなります。(つまり、(void *))

C.CBytes()は、内部でmallocを呼び出しヒープメモリを確保するので、利用後に必ずC.free()を呼び出してメモリを解放する必要があります。

サンプル

main.go

package main

/*
#cgo CFLAGS: -Wall

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#define SKIP_BYTES 6

void p1(const void *data) {
   printf("%s\n", (char *)data);
}

void p2(void *data) {
   void *buf = data + SKIP_BYTES;
   printf("%s\n", (char *)buf);
}

void p3(char *data) {
   char *buf = data + SKIP_BYTES;
   printf("%s\n", buf);
}
*/
import "C"

func main() {
    //
    // []byteをC側のバイト列にするには C.CBytes()を利用する.
    //
    var (
        goBytes = []byte("hello Go world")
        cBytes  = C.CBytes(goBytes)
    )

    // C.CBytes() は、malloc() にてメモリを確保しているので、C.free() の呼び出しが必須
    defer C.free(cBytes)

    C.p1(cBytes)
    C.p2(cBytes)
    C.p3((*C.char)(cBytes))
}

Taskfile.yml

# https://taskfile.dev

version: '3'

tasks:
  default:
    cmds:
      - go run main.go

実行

$ task
task: [default] go run main.go
hello Go world
Go world
Go world

参考情報

Goのおすすめ書籍

初めてのGo言語 ―他言語プログラマーのためのイディオマティックGo実践ガイド

作者:Jon Bodner
オーム社

Amazon

実用 Go言語 ―システム開発の現場で知っておきたいアドバイス

作者:渋川よしき,辻大志郎,真野隼記
オライリージャパン

Amazon

Go言語による並行処理

作者:Katherine Cox-Buday
オライリージャパン

Amazon

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ

作者:Teiva Harsanyi,柴田芳樹
インプレス

Amazon

Goならわかるシステムプログラミング第2版

作者:渋川よしき
ラムダノート

Amazon

効率的なGo ―データ指向によるGoアプリケーションの性能最適化

作者:Bartłomiej Płotka
オライリージャパン

Amazon

過去の記事については、以下のページからご参照下さい。

ブログ「いろいろ備忘録日記」の記事まとめ | ブログ「いろいろ備忘録日記」のまとめ

サンプルコードは、以下の場所で公開しています。

いろいろ備忘録日記

主に .NET とか Go とか Flutter とか Python絡みのメモを公開しています。

Goメモ-511 (cgoメモ-07)(C.CBytes)([]byteをCのバイト列に)

関連記事

概要

サンプル

main.go

Taskfile.yml

実行

参考情報

Goのおすすめ書籍