Handler erweitern

Eigene IInvocationHandler implementieren und im InvocationDispatcher registrieren.

Handler-System

Jeder Methoden-Aufruf im C#-Code läuft durch den InvocationDispatcher, der eine geordnete Liste von IInvocationHandler-Implementierungen nacheinander probiert. Der erste Handler der true zurückgibt "gewinnt".

Schritt 1: Handler implementieren

// Transpiler/Handlers/MyNewHandler.cs
public sealed class MyNewHandler : InvocationHandlerBase
{
    public override bool TryHandle(
        InvocationExpressionSyntax inv,
        string calleeStr,
        List<string> args,
        TranspilerContext ctx,
        Func<SyntaxNode?, string> writeExpr,
        out string result)
    {
        // Nicht zuständig → false zurückgeben
        if (calleeStr != "MyApi.DoSomething")
            return NotHandled(out result);

        // Zuständig → C-Code erzeugen
        result = $"my_c_function({ArgAt(args, 0)}, {ArgAt(args, 1)})";
        return true;
    }
}

Schritt 2: Im Dispatcher registrieren

// Transpiler/Handlers/InvocationDispatcher.cs
private static readonly IReadOnlyList<IInvocationHandler> s_handlers =
    new List<IInvocationHandler>
{
    new LibNxHandler(),
    new EnvironmentHandler(),
    // ... bestehende Handler ...
    new MyNewHandler(),       // ← hier einfügen (vor OwnMethodHandler)
    new StaticClassHandler(),
    new OwnMethodHandler(),
};
Immer vor OwnMethodHandler und StaticClassHandler eintragen — diese sind Fallback-Handler und greifen sonst zu früh.

InvocationHandlerBase Hilfsmethoden

MethodeBeschreibung
ArgAt(args, i)i-tes Argument (oder "" wenn nicht vorhanden)
JoinArgs(args)Alle Argumente mit ", " verbunden
NotHandled(out result)Gibt false zurück, result = null
TryResolveList(obj, ctx, ...)List<T>-Typ und -Ausdruck auflösen
TryResolveDict(obj, ctx, ...)Dictionary-Typ und -Ausdruck auflösen
ListFuncPrefix(listType)"List<string>" → "List_str"
DictFuncPrefix(dictType)"Dictionary<string,int>" → "Dict_str_int"

Neuen Typ registrieren

Neue C#→C Typ-Mappings kommen in Core/TypeRegistry.cs:

// In s_primitives Dictionary:
["MeinTyp"] = "MeinC_Typ",

// Für Stack-Structs (kein malloc):
// → s_libNxStructs HashSet hinzufügen

// Für printf Format-Specifier:
// → s_formatSpecifiers Dictionary ergänzen

Beispiel: Handler für eine neue API

// Angenommen: neue "Network" API mit Network.Get(url)
public sealed class NetworkHandler : InvocationHandlerBase
{
    private static readonly Dictionary<string, string> s_map =
        new(StringComparer.Ordinal)
        {
            ["Network.Init"]    = "cs2sx_net_init",
            ["Network.Get"]     = "cs2sx_net_get",
            ["Network.IsReady"] = "cs2sx_net_ready",
        };

    public override bool TryHandle(InvocationExpressionSyntax inv,
        string calleeStr, List<string> args, TranspilerContext ctx,
        Func<SyntaxNode?, string> writeExpr, out string result)
    {
        if (!s_map.TryGetValue(calleeStr, out var cFunc))
            return NotHandled(out result);

        result = cFunc + "(" + JoinArgs(args) + ")";
        return true;
    }
}