preg_replace_callback() — internals

preg_replace_callback() — internals

Where it lives

• Signature: src/builtins/callables/preg_replace_callback.rs
• Lowering: src/builtins/semantics.rs:639 (lower_registry_call)
• Function symbol: lower_registry_call()

Lowering notes

• Uses the runtime_call strategy from the single-source builtin descriptor.
• Emits the typed EIR target runtime.preg_replace_callback through BuiltinLoweringContext.
• The backend resolves that typed target through src/codegen/lower_inst/runtime_calls.rs; PHP builtin names do not participate in dispatch.

Semantic descriptor

• Target strategy: runtime_call
• Validation: checker_hook
• Result type source: checked
• Result ownership: may_alias_arguments
• Effects: static (16 declared effects)
• Requirements: static (0 requirements)
• Callable policy: static_only
• Target support: macos-aarch64, ios-arm64, ios-sim-arm64, linux-aarch64, linux-x86_64

EIR and runtime boundary

• Typed EIR target: runtime.preg_replace_callback
• Backend boundary: src/codegen/lower_inst/runtime_calls.rs resolves the typed target without PHP-name dispatch.

Signature summary

function preg_replace_callback(string $pattern, callable $callback, string $subject): string

What the type checker enforces

• Arity: takes exactly 3 arguments.

Eval interpreter (magician)

• Declaration: crates/elephc-magician/src/interpreter/builtins/regex/preg_replace_callback.rs (eval_builtin!)
• Execution: Magician interpreter adapter.
• Adapter reason: callable-or-reflection.
• Dispatch hooks: direct, values

Cross-references

• User reference for preg_replace_callback()