c2go

Ein Werkzeug zum Konvertieren von C zum Umgang.

Die Ziele dieses Projekts sind:

1. So erstellen Sie ein generisches Werkzeug, das C so konvertieren kann.
2. Cross -Plattform (Linux und MAC) sein und gegen so viele Klangversionen wie möglich arbeiten (die Clang AST -API ist nicht stabil).
3. Um ein wiederholbares und vorhersehbares Werkzeug zu sein (anstatt den größten Teil der Arbeit zu erledigen, müssen Sie die Ausgabe bereinigen, um sie zum Laufen zu bringen.)
4. Um schnelle und kleine Versionen zu liefern.
5. Der ultimative Meilenstein besteht darin, den SQLite3 -Quellcode kompilieren zu können und ihn ohne Änderung funktionieren zu lassen. Dies wird die Veröffentlichung von 1.0.0 sein.

Installation

c2go erfordert GO 1,9 oder neuer.

go get -u github.com/elliotchance/c2go

Verwendung

c2go transpile myfile.c

Das c2go -Programm verarbeitet eine einzelne C -Datei und gibt den übersetzten Code in GO aus. Verwenden wir ein inklusives Beispiel, Prime.c:

 #include <stdio.h>
 
int main ()
{
   int n , c ;
 
   printf ( "Enter a numbern" );
   scanf ( "%d" , & n );
 
   if ( n == 2 )
      printf ( "Prime number.n" );
   else
   {
       for ( c = 2 ; c <= n - 1 ; c ++ )
       {
           if ( n % c == 0 )
              break ;
       }
       if ( c != n )
          printf ( "Not prime.n" );
       else
          printf ( "Prime number.n" );
   }
   return 0 ;
}

c2go transpile prime.c
go run prime.go

 Enter a number
23
Prime number.

prime.go sieht aus:

 package main

import "unsafe"

import "github.com/elliotchance/c2go/noarch"

// ... lots of system types in Go removed for brevity.

var stdin * noarch. File
var stdout * noarch. File
var stderr * noarch. File

func main () {
	__init ()
	var n int
	var c int
	noarch . Printf ([] byte ( "Enter a number n x00 " ))
	noarch . Scanf ([] byte ( "%d x00 " ), ( * [ 1 ] int )( unsafe . Pointer ( & n ))[:])
	if n == 2 {
		noarch . Printf ([] byte ( "Prime number. n x00 " ))
	} else {
		for c = 2 ; c <= n - 1 ; func () int {
			c += 1
			return c
		}() {
			if n % c == 0 {
				break
			}
		}
		if c != n {
			noarch . Printf ([] byte ( "Not prime. n x00 " ))
		} else {
			noarch . Printf ([] byte ( "Prime number. n x00 " ))
		}
	}
	return
}

func __init () {
	stdin = noarch . Stdin
	stdout = noarch . Stdout
	stderr = noarch . Stderr
}

Wie es funktioniert

Dies ist der Prozess:

1. Der C -Code ist mit Klang vorverarbeitet. Dies generiert eine größere Datei ( pp.c ), entfernt jedoch alle plattformspezifischen Richtlinien und Makros.

2. pp.c wird mit dem Clang AST analysiert und steckt es in ein farbenfrohes Textformat, das so aussieht. Abgesehen davon, dass das C nur das C analysiert und ein AST abgelegt hat, enthält der AST alle aufgelösten Informationen, die ein Compiler benötigt (z. B. Datentypen). Dies bedeutet, dass der Code erfolgreich unter Clang kompiliert werden muss, damit der AST ebenfalls verwendbar ist.

3. Da wir alle Typen im AST haben, geht es nur darum, den Baum auf halbbetriebige Weise zu durchqueren und GO zu produzieren. Einfach, richtig !?

Testen

Standardmäßig werden nur Unit -Tests mit go test durchgeführt. Sie können auch die Integrationstests einfügen:

go test -tags=integration ./...

Integrationstests in Form von vollständigen C -Programmen, die im Testverzeichnis zu finden sind.

Integrationstests funktionieren wie folgt:

1. Clang kompiliert das C wie gewohnt zu einem Binärer.
2. C2GO konvertiert die C -Datei, um zu gehen.
3. Das GO ist gebaut, um ein weiteres Binärer zu produzieren.
4. Beide Binärdateien werden ausgeführt und der Ausgang wird verglichen. Alle C -Dateien enthalten eine Ausgabe, damit die Ergebnisse überprüft werden können.

Beitragen

Der Beitrag erfolgt mit Pull -Anfragen. Es gibt keine Hilfe, die zu klein ist! :)

Wenn Sie suchen, wo ich anfangen soll, kann ich vorschlagen, ein einfaches C -Programm (wie die anderen Beispiele) zu finden, das sich nicht erfolgreich in Go übersetzt.

Oder wenn Sie dies nicht tun möchten, können Sie es als Problem einreichen, damit es von jemand anderem abgeholt werden kann.