関連記事
Goメモ-502 (cgoメモ-01)(cgoヘッダ) - いろいろ備忘録日記
Goメモ-506 (cgoメモ-02)(cgoヘッダ) - いろいろ備忘録日記
Goメモ-507 (cgoメモ-03)(C.int) - いろいろ備忘録日記
Goメモ-508 (cgoメモ-04)(C言語の構造体) - いろいろ備忘録日記
Goメモ-509 (cgoメモ-05)(C.CString)(Cの文字列) - いろいろ備忘録日記
Goメモ-510 (cgoメモ-06)(C.GoString)(Cの文字列をGoの文字列へ) - いろいろ備忘録日記
Goメモ-511 (cgoメモ-07)(C.CBytes)([]byteをCのバイト列に) - いろいろ備忘録日記
Goメモ-512 (cgoメモ-08)(C.GoBytes)(Cのバイト列をGoの[]byteへ) - いろいろ備忘録日記
Goメモ-514 (cgoメモ-09)(C.GoStringN)(C.GoStringのサイズ指定版) - いろいろ備忘録日記
Goメモ-515 (cgoメモ-10)([]byteを(void *)へ変換) - いろいろ備忘録日記
Goメモ-516 (cgoメモ-11)([]byteを(char *)へ変換) - いろいろ備忘録日記
Goメモ-518 (cgoメモ-12)(Cのmallocをcgo経由で呼び出し) - いろいろ備忘録日記
Goメモ-519 (cgoメモ-13)(ポインタ演算) - いろいろ備忘録日記
Goメモ-520 (cgoメモ-14)(Goの関数をCの世界に公開 (export)) - いろいろ備忘録日記
Goメモ-522 (cgoメモ-15)(Goでsoファイルを作成してC言語から呼び出し) - いろいろ備忘録日記
Goメモ-525 (cgoメモ-16)(C側にて関数ポインタを引数に要求する関数にGo側で定義した関数を設定) - いろいろ備忘録日記
Goメモ-526 (cgoメモ-17)(cgoとdlopen関数を使って既存ライブラリの呼び出しをフックする) - いろいろ備忘録日記
Goメモ-527 (cgoメモ-18)(cgoを利用している場合のinit関数について) - いろいろ備忘録日記
Goメモ-528 (cgoメモ-19)(cgoを利用して作成したsoファイル経由でのinit関数の呼び出し) - いろいろ備忘録日記
Goメモ-529 (cgoメモ-20)(C言語のNULLをcgoから渡す) - いろいろ備忘録日記
Goメモ-530 (cgoメモ-21)(CGOヘッダーで指定出来るCFLAGS, LDFLAGS) - いろいろ備忘録日記
Goメモ-531 (cgoメモ-22)(CGOで利用するコンパイラを変更する) - いろいろ備忘録日記
Goメモ-532 (cgoメモ-23)(CGOヘッダで使えるSRCDIR変数) - いろいろ備忘録日記
GitHub - devlights/blog-summary: ブログ「いろいろ備忘録日記」のまとめ
概要
以下、自分用のメモです。
今回から複数回に渡って cgo についてメモしていこうと思います。
cgo は、文字通りGoからCにアクセスすることが出来るようになるものなのですが、とても便利な反面、結構クセが強いのでメモでも残しておかないとすぐ頭から消えてしまいそうだなって思いました。
Cgo is not Go
という格言があったりするので、Go界隈で標準で推奨されていない技術かもしれません。が、実務ではC言語で作成されたライブラリなどは山のようにあります。んで、プロジェクトの方針でGoで作り直すことも出来ない場合も多々あります。そのような場合に非常に便利です。
これからのサンプルは以下のリポジトリにアップしてありますので、良ければご参考ください。
今回は C側の構造体にて固定要素数の文字配列をGo側で文字列に変換について。
例えば、C側で以下の構造体を定義しているとします。
typedef struct _Data { char name[10]; } Data;
上記のC構造体は以下のような形でcgo側に展開されます。
type _Ctype_struct__Data struct { name [10]_Ctype_char }
Goで配列は要素数も含めて型となるため、そのままでは (char *) としては利用できません。
Cの文字列をGoの文字列として利用する際に使う C.GoString() は (char *) を引数に要求します。
変換を行うには一旦 unsafe.Pointer にしてから、望みの型へとキャストします。
尚、Goの世界ではC言語のように「配列の先頭要素は暗黙的に配列自体のポインタを表す」というルールにはなりませんので、明示的に先頭要素のポインタを指定します。
サンプル
main.go
package main /* #include <string.h> #include <stdlib.h> typedef struct _Data { char name[10]; } Data; static int Init_Data(Data* v) { const char msg[] = "Hello Go"; strncpy(v->name, msg, sizeof(msg)-1); v->name[sizeof(msg)-1] = '\0'; return EXIT_SUCCESS; } */ import "C" import ( "log" "unsafe" ) func init() { log.SetFlags(0) } func main() { var data C.Data C.Init_Data(&data) /* Data構造体は以下のような形でcgo側に展開される type _Ctype_struct___0 struct { name [10]_Ctype_char } Goで配列は要素数も含めて型となるため そのままでは (char *) としては利用できない。 Cの文字列をGoの文字列として利用する際に 使う C.GoString() は (char *) を引数に要求する。 変換を行うには一旦 unsafe.Pointer にしてから 望みの型へとキャストする。 尚、Goの世界ではC言語のように「配列の先頭要素は暗黙的に配列自体のポインタを表す」と いうルールにはならないので、明示的に先頭要素のポインタを指定する。 */ p := unsafe.Pointer(&data.name[0]) // unsafe.Pointerにしてから c := (*C.char)(p) // (char *) にキャストし s := C.GoString(c) // Goの文字列に変換 log.Println(s) }
Taskfile.yml
# https://taskfile.dev version: '3' tasks: default: cmds: - task: run clean: cmds: - rm -f ./app run: cmds: - go build -o app . - ./app
実行
$ task task: [run] go build -o app . task: [run] ./app Hello Go
参考情報
- C? Go? Cgo!
- Go Wiki: cgo
- cmd/cgo
- runtime/cgo
- cgoを使ったCとGoのリンクの裏側 (1)
- cgoを使ったCとGoのリンクの裏側 (2)
- ebitengine/purego
- JupiterRider/ffi
個人的Goのおすすめ書籍
個人的に読んでとても勉強になった書籍さんたちです。
過去の記事については、以下のページからご参照下さい。
サンプルコードは、以下の場所で公開しています。