Einschränkungen

Bekannte Grenzen des CS2SX-Transpilers und was nicht unterstützt wird.

CS2SX ist ein Transpiler für Nintendo Switch Homebrew — nicht ein vollständiger C#-Compiler. Einige Features die in .NET problemlos funktionieren sind auf der Switch nicht sinnvoll oder nicht umsetzbar.

Projektstruktur

Limit

Eine Klasse pro .cs-Datei

Keine verschachtelten Klassen, keine mehrfachen Top-Level-Klassen in einer Datei.

Limit

Genau ein SwitchApp-Subtyp pro Projekt

Nur eine Klasse darf von SwitchApp erben — das ist der App-Einstiegspunkt.

Speicher & Strings

Achtung

String-Puffer 512 Bytes

Interne String-Operationen (snprintf, Konkatenation) nutzen statische 512-Byte-Puffer. Verschachtelte String-Methoden können sich überschreiben.

Achtung

Kein Heap-GC

Allokierte Objekte (*_New()) müssen manuell freigegeben werden. CS2SX hat keinen Garbage Collector.

Achtung

Dateipuffer 8192 Bytes

File.ReadAllText() liest maximal 8192 Bytes.

Nicht unterstützte Features

FeatureGrund
async / awaitKein .NET Runtime auf der Switch
LINQErfordert Generics + Runtime-Support
interfaceNicht transpiliert (vtable deckt die meisten Fälle ab)
GenericsC hat kein Generics-Äquivalent auf Compiler-Ebene
params (teilweise)Variadic-Funktionen in C sind eingeschränkt
Console.ReadLineDie Switch hat keine Tastatur-Eingabe (Homebrew)
MehrfachvererbungC unterstützt keine Mehrfachvererbung
delegate als TypNur teilweise — einfache Action/Func werden unterstützt
Tuple-Return / DekonstruktionExperimentell, eingeschränkt

Bekannte Einschränkungen

Info

Bitmap-Font 8×8

Kein Anti-Aliasing, kein TrueType. Nur ASCII 32–127 (CP437).

Info

Lambda-Captures

Nur Werttypen und primitive Captures zuverlässig. Referenz-Captures auf Heap-Objekte können zu Dangling-Pointer-Problemen führen.

Info

Mehrdimensionale Arrays

int[,] wird als flaches 1D-Array transpiliert. Manuelle Index-Berechnung nötig.

Info

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));