cxgo

C to Go-Übersetzer

CxGo ist ein Tool zum Übersetzen von C-Quellcode in Go (auch bekannt als Transpiler, Source-to-Source-Compiler).

Es verwendet cc v3 für die Vorverarbeitung und Analyse von C (keine clang/gcc-Abhängigkeiten!) sowie einen benutzerdefinierten Typprüfer und eine AST-Übersetzungsschicht, um die bestmögliche Ausgabe zu erzielen.

Die einzige Voraussetzung ist: C-Code muss mit cxgo kompiliert werden, einschließlich Header.

Allerdings nutzt cxgo ein paar Tricks, um diesen Prozess zu vereinfachen.

TL;DR für die Projektziele:

1. Implementieren Sie einen praktischen C-to-Go-Übersetzer (derzeit kein C++).
2. Achten Sie darauf, dass der ausgegebene Programmcode korrekt ist.
3. Machen Sie den generierten Code für Menschen lesbar und so idiomatisch wie möglich.
4. Machen Sie es einfach zu verwenden und anzupassen.

Weitere häufig gestellte Fragen zum Projekt finden Sie in den FAQ.

Status

Das Projekt ist experimentell ! Verlassen Sie sich in der Produktion und anderen sensiblen Umgebungen nicht darauf!

Obwohl es in mehreren Projekten erfolgreich getestet wurde, kann es aufgrund noch unbekannter Fehler zu Änderungen im Verhalten des Codes kommen.

Compiler-Testergebnisse:

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

Transpilierte Projekte:

• Potrace (Bildvektorisierungsbibliothek)
• G722 (Audio-Codec)
• PortableGL (OpenGL 3.x-Implementierung)
• Physac (2D-Physik-Engine)

Installation

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

oder laden Sie die neueste Version von Github herunter.

Wie zu verwenden

Der schnellste Weg, es auszuprobieren, ist:

cxgo file main.c

Weitere Informationen finden Sie in unserem Beispielbereich.

Es führt Sie durch grundlegende Nutzungsmuster sowie durch fortgeschrittenere (an realen Projekten).

Sie können auch die FAQ durchsehen, wenn Sie Probleme haben.

Vorbehalte

Die folgenden C-Funktionen werden derzeit von cxgo akzeptiert, können jedoch teilweise oder überhaupt nicht implementiert werden:

• Kommentare aus C-Code beibehalten (#2)
• static (#4)
• auto (#5)
• Bitfelder (#6)
• union mit C-identischem Datenlayout (#7)
• packed Strukturen (#8)
• asm
• case an seltsamen Orten (#9)
• goto verboten durch Go (es gibt jedoch einen Workaround, siehe #10)
• Etikettenvariablen (#11)
• Thread-Lokalspeicher (#12)
• setjmp (wird kompiliert, gerät aber zur Laufzeit in Panik)
• Einige stdlib-Funktionen und -Typen fehlen (gute erste Ausgabe!)
• tiefe Typinferenz (beim Konvertieren in Go-String/Slices)
• Berücksichtigung mehrerer #ifdef Pfade für verschiedene Betriebssysteme/Umgebungen

Gemeinschaft

Treten Sie unserer Community bei! Wir würden uns freuen, von Ihnen zu hören!

Mitwirken

Siehe BEITRAGEN.

Lizenz

MIT