array_splice() — internals

array_splice() — internals

Where it lives

• Signature: src/builtins/array/array_splice.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.array_splice 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: fresh
• 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.array_splice
• Backend boundary: src/codegen/lower_inst/runtime_calls.rs resolves the typed target without PHP-name dispatch.

Signature summary

function array_splice(array $array, int $offset, int $length = null, array $replacement = []): array

What the type checker enforces

• Arity: takes 2–4 arguments (2 optional).
• By-reference parameters: $array.

Eval interpreter (magician)

• Declaration: crates/elephc-magician/src/interpreter/builtins/array/array_splice.rs (eval_builtin!)
• Execution: Magician interpreter adapter.
• Adapter reason: by-reference-or-lvalue.
• Dispatch hooks: values
• By-reference parameters: $array.

Cross-references

• User reference for array_splice()