Class EfunRegistry

java.lang.Object
io.github.protasm.jvmud.compiler.efun.EfunRegistry
public final class EfunRegistry extends Object
Instance-scoped registry for LPC-facing engine functions.

The registry is owned by a runtime context rather than by global process state, so each hosted mudlib/runtime can choose which efuns it exposes. Built-in JVMud efuns are registered from CoreEfuns; embedders and tests may register additional implementations before compiled LPC code executes.

Lookup is by function name and compatible arity. Exact fixed-arity signatures are preferred over varargs signatures. Registering two equally good implementations is allowed at insertion time but treated as a configuration error when that overload is looked up, which prevents the runtime from silently invoking the wrong function.

  • Constructor Details

    • EfunRegistry

      public EfunRegistry()

  • Method Details

    • register

      public void register(Efun efun)
      Registers an engine function implementation.
      Parameters:
      efun - implementation to add to this registry
      Throws:
      NullPointerException - if efun is null

    • lookup

      public Efun lookup(String name, int arity)
      Returns the matching function for name and arity.
      Parameters:
      name - LPC-facing function name
      arity - actual number of LPC arguments in the call
      Returns:
      matching efun, or null when none is registered
      Throws:
      IllegalStateException - if more than one implementation is the best match for the arity

    • signatures

      public List<EfunSignature> signatures(String name)
      Returns all registered signatures for a function name.

      This is useful for diagnostics and compiler error messages that need to show the overloads available for an unresolved or incorrectly-called efun.

      Parameters:
      name - LPC-facing function name
      Returns:
      immutable list of signatures currently registered for name