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
| Methode | Beschreibung |
|---|---|
| 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änzenBeispiel: 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;
}
}