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

KlasseAufgabe
CSharpToCRoot-Walker: Klassen, Enums, Structs, Methoden
ExpressionWriterAlle Ausdrücke → C-Strings (rekursiv)
StatementWriterAlle Statements → C-Code (if, for, foreach, switch...)
InvocationDispatcherOrchestriert alle IInvocationHandler in Prioritäts-Reihenfolge
TranspilerContextGeteilter Zustand: Typen, Felder, Indentierung, Diagnostics
TypeRegistryEinzige Quelle aller C#→C Typ-Mappings
VTableBuildervtable-Infrastruktur für virtuelle Methoden
LambdaLifterLambda-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:

  1. Semantic (bevorzugt): Roslyn GetTypeInfo(node) via SemanticModel — präzise für alle Typen inkl. generische Parameter
  2. Syntaktisch (Fallback): Pattern-Matching auf AST-Knoten — für Fälle wo das SemanticModel keinen Typ liefert

Konstruktor-Strategien

StrategieTrifft zu aufGeneriert
SwitchAppConstructorStrategySubklassen von SwitchAppClassName_Init() mit Lifecycle-Funktionszeigern
ControlSubclassConstructorStrategySubklassen von Control/Button/LabelClassName_New() mit Draw/Update-Zeigern
DefaultConstructorStrategyAlle anderen KlassenClassName_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().