Transpiler
Architektur des CS2SX C#→C Transpilers — Writer, Handler, Strategien und Kontext.
Überblick
Der Transpiler besteht aus einem Roslyn CSharpSyntaxWalker der den AST traversiert
und über spezialisierte Writer und Handler C-Code generiert. Der gesamte Zustand läuft durch einen TranspilerContext — kein globaler State.
Hauptkomponenten
| Klasse | Aufgabe |
|---|---|
| CSharpToC | Root-Walker: Klassen, Enums, Structs, Methoden |
| ExpressionWriter | Alle Ausdrücke → C-Strings (rekursiv) |
| StatementWriter | Alle Statements → C-Code (if, for, foreach, switch...) |
| InvocationDispatcher | Orchestriert alle IInvocationHandler in Prioritäts-Reihenfolge |
| TranspilerContext | Geteilter Zustand: Typen, Felder, Indentierung, Diagnostics |
| TypeRegistry | Einzige Quelle aller C#→C Typ-Mappings |
| VTableBuilder | vtable-Infrastruktur für virtuelle Methoden |
| LambdaLifter | Lambda-Expressions zu benannten C-Funktionen heben |
Transpile-Modi
HeaderOnly
Generiert .h-Datei: struct-Definitionen, vtable-Structs, Funktionssignaturen, extern-Deklarationen.
Implementation
Generiert .c-Datei: Konstruktoren, Methoden-Bodies, vtable-Instanzen, static-Feld-Definitionen.
Typ-Inferenz
Der TypeInferrer kombiniert zwei Strategien:
- Semantic (bevorzugt): Roslyn
GetTypeInfo(node)via SemanticModel — präzise für alle Typen inkl. generische Parameter - Syntaktisch (Fallback): Pattern-Matching auf AST-Knoten — für Fälle wo das SemanticModel keinen Typ liefert
Konstruktor-Strategien
| Strategie | Trifft zu auf | Generiert |
|---|---|---|
| SwitchAppConstructorStrategy | Subklassen von SwitchApp | ClassName_Init() mit Lifecycle-Funktionszeigern |
| ControlSubclassConstructorStrategy | Subklassen von Control/Button/Label | ClassName_New() mit Draw/Update-Zeigern |
| DefaultConstructorStrategy | Alle anderen Klassen | ClassName_New(params) mit malloc + Feld-Init |
VTable-System
// C# Input:
abstract class Animal { abstract void Speak(); }
class Dog : Animal { override void Speak() { } }
// C Output (vereinfacht):
typedef struct Animal_vtable {
void (*Speak)(void* self);
} Animal_vtable;
typedef struct Dog {
Animal_vtable* vtable;
// Felder...
} Dog;
static Animal_vtable Dog_vtable_instance = {
.Speak = Dog_Speak,
};
// Virtueller Aufruf: animal->vtable->Speak(animal)String-Konkatenation
Der StringConcatFixer wandelt "Score: " + score.ToString() zu snprintf(_sb0, sizeof(_sb0), "Score: %d", score) um.
Interpolierte Strings ($"...") in Argument-Position erzeugen ebenfalls einen snprintf-Puffer — nicht printf().