Einschränkungen
Bekannte Grenzen des CS2SX-Transpilers und was nicht unterstützt wird.
Projektstruktur
Eine Klasse pro .cs-Datei
Keine verschachtelten Klassen, keine mehrfachen Top-Level-Klassen in einer Datei.
Genau ein SwitchApp-Subtyp pro Projekt
Nur eine Klasse darf von SwitchApp erben — das ist der App-Einstiegspunkt.
Speicher & Strings
String-Puffer 512 Bytes
Interne String-Operationen (snprintf, Konkatenation) nutzen statische 512-Byte-Puffer. Verschachtelte String-Methoden können sich überschreiben.
Kein Heap-GC
Allokierte Objekte (*_New()) müssen manuell freigegeben werden. CS2SX hat keinen Garbage Collector.
Dateipuffer 8192 Bytes
File.ReadAllText() liest maximal 8192 Bytes.
Nicht unterstützte Features
| Feature | Grund |
|---|---|
| async / await | Kein .NET Runtime auf der Switch |
| LINQ | Erfordert Generics + Runtime-Support |
| interface | Nicht transpiliert (vtable deckt die meisten Fälle ab) |
| Generics | C hat kein Generics-Äquivalent auf Compiler-Ebene |
| params (teilweise) | Variadic-Funktionen in C sind eingeschränkt |
| Console.ReadLine | Die Switch hat keine Tastatur-Eingabe (Homebrew) |
| Mehrfachvererbung | C unterstützt keine Mehrfachvererbung |
| delegate als Typ | Nur teilweise — einfache Action/Func werden unterstützt |
| Tuple-Return / Dekonstruktion | Experimentell, eingeschränkt |
Bekannte Einschränkungen
Bitmap-Font 8×8
Kein Anti-Aliasing, kein TrueType. Nur ASCII 32–127 (CP437).
Lambda-Captures
Nur Werttypen und primitive Captures zuverlässig. Referenz-Captures auf Heap-Objekte können zu Dangling-Pointer-Problemen führen.
Mehrdimensionale Arrays
int[,] wird als flaches 1D-Array transpiliert. Manuelle Index-Berechnung nötig.
Audio blockiert bei Pufferübergabe
PlayTone wartet auf freien PCM-Puffer wenn alle 4 zirkulären Puffer belegt sind.
Workarounds
// ✗ Mehrdimensionales Array
int[,] grid = new int[10, 10];
grid[2, 3] = 1; // funktioniert nicht korrekt
// ✓ Workaround: 1D-Array + manuelle Berechnung
int[] grid = new int[100]; // 10×10
int W = 10;
grid[2 * W + 3] = 1; // grid[row * width + col]
// ✗ LINQ
var filtered = items.Where(x => x > 5).ToList();
// ✓ Workaround: for-Schleife
var filtered = new List<int>();
for (int i = 0; i < items.Count; i++)
if (items.Get(i) > 5)
filtered.Add(items.Get(i));