CXGO

C to Go トランスレータ

CxGo は、C ソース コードを Go に変換するツールです (トランスパイラー、ソース間コンパイラーとも呼ばれます)。

C の前処理と解析に cc v3 を使用し (clang/gcc 依存関係はありません!)、カスタムの型チェッカーと AST 変換層を使用して、可能な限り最高の出力を実現します。

唯一の要件は、C コードはヘッダーを含めてcxgoでコンパイルする必要があることです。

そうは言っても、 cxgoこのプロセスを簡単にするためにいくつかのトリックを使用します。

プロジェクトの目標に関する TL;DR:

1. 実用的な C to Go トランスレーターを実装します (現時点では C++ はありません)。
2. 出力されたプログラムコードを正しい状態に保ってください。
3. 生成されたコードは人間が判読できるように、できるだけ慣用的なものにします。
4. 使いやすく、カスタマイズしやすくします。

プロジェクトに関する一般的な質問については、FAQ を確認してください。

状態

このプロジェクトは実験的なものです!本番環境やその他の機密性の高い環境では、これに依存しないでください。

複数のプロジェクトでテストは成功しましたが、まだ未知のバグによりコードの動作が変わる可能性があります。

コンパイラのテスト結果:

• TCC: 62/89 (70%)
• GCC: 783/1236 (63%)

トランスパイルされたプロジェクト:

• Potrace (画像ベクトル化ライブラリ)
• G722 (オーディオ コーデック)
• PortableGL (OpenGL 3.x 実装)
• Physac (2D 物理エンジン)

インストール

go install github.com/gotranspile/cxgo/cmd/cxgo@latest

または、Github から最新リリースをダウンロードします。

使用方法

それを試す最も速い方法は次のとおりです。

cxgo file main.c

詳細については、例のセクションを確認してください。

基本的な使用パターンだけでなく、より高度な使用パターン (実際のプロジェクトでの) もガイドします。

問題がある場合は、FAQ も確認してください。

注意事項

以下の C 機能は現在cxgoで受け入れられていますが、部分的に実装されるか、まったく実装されない可能性があります。

• C コードのコメントを保持する (#2)
• static (#4)
• auto (#5)
• ビットフィールド (#6)
• C と同一のデータ レイアウトを使用したunion (#7)
• packed構造体 (#8)
• asm
• 奇妙な場所にcase (#9)
• goto Go によって禁止されています (ただし、回避策はあります。#10 を参照)
• ラベル変数 (#11)
• スレッドローカルストレージ (#12)
• setjmp (コンパイルは実行されますが、実行時にパニックが発生します)
• 一部の stdlib 関数と型が欠落しています (最初の問題は良好です!)
• 深い型推論 (Go 文字列/スライスに変換する場合)
• 異なる OS/環境に対する複数の#ifdefパスを考慮する

コミュニティ

私たちのコミュニティに参加してください！ご連絡をお待ちしております。

貢献する

「貢献」を参照してください。

ライセンス

マサチューセッツ工科大学