Files
sx/src/backend/llvm/ops.zig
agra d88bdd7242 fix(0128): foreign cstring returns + conflicting same-symbol bindings
Two genuine defects behind the 0128 filing (whose original repros were
both poisoned by binding getenv, which std already declares -> *u8):

1. Re-declaring a C symbol was silent first-wins: every call through
   the later declaration was typed by the older signature. Foreign
   registration now dedupes — equal signatures share one FuncId,
   conflicting ones are diagnosed.

2. Foreign -> string / -> ?string returns read garbage: C returns one
   char*, but the LLVM signature declared the fat {ptr,i64} (len =
   register garbage), and ?string was mis-declared SRET (the hidden
   out-pointer landed in the callee's first arg register). cstrRetKind
   now classifies such returns, declares them as plain ptr (never
   sret), and the call site synthesizes {ptr, strlen} via a
   branch-guarded strlen (NULL -> {null,0} / optional null), wrapping
   {string, i1} for ?string.

?[:0]u8 itself resolves fine (it is ?string); the spelling works in
return, param, local, and alias positions.

Regression: examples/1221 (plain + optional non-null + NULL paths) and
examples/1172 (conflict diagnostic); both FAIL pre-fix. The extern
dedupe collapses duplicate libc decls, so affected .ir snapshots were
regenerated. zig build test 426/426; run_examples 602/602;
distribution suite 21/21.
2026-06-12 14:13:01 +03:00

2001 lines
105 KiB
Zig

const std = @import("std");
const llvm = @import("../../llvm_api.zig");
const c = llvm.c;
const emit = @import("../../ir/emit_llvm.zig");
const ir_inst = @import("../../ir/inst.zig");
const ir_types = @import("../../ir/types.zig");
const interp_mod = @import("../../ir/interp.zig");
const LLVMEmitter = emit.LLVMEmitter;
const Interpreter = interp_mod.Interpreter;
const Inst = ir_inst.Inst;
const BinOp = ir_inst.BinOp;
const UnaryOp = ir_inst.UnaryOp;
const Aggregate = ir_inst.Aggregate;
const FieldAccess = ir_inst.FieldAccess;
const EnumInit = ir_inst.EnumInit;
const Subslice = ir_inst.Subslice;
const Store = ir_inst.Store;
const Conversion = ir_inst.Conversion;
const GlobalId = ir_inst.GlobalId;
const GlobalSet = ir_inst.GlobalSet;
const FuncId = ir_inst.FuncId;
const Call = ir_inst.Call;
const CallIndirect = ir_inst.CallIndirect;
const ObjcMsgSend = ir_inst.ObjcMsgSend;
const JniMsgSend = ir_inst.JniMsgSend;
const BuiltinCall = ir_inst.BuiltinCall;
const TriOp = ir_inst.TriOp;
const Branch = ir_inst.Branch;
const CondBranch = ir_inst.CondBranch;
const SwitchBranch = ir_inst.SwitchBranch;
const BoxAny = ir_inst.BoxAny;
const ClosureCreate = ir_inst.ClosureCreate;
const BlockParam = ir_inst.BlockParam;
const FieldReflect = ir_inst.FieldReflect;
const TypeId = ir_types.TypeId;
const StringId = ir_types.StringId;
const Ref = ir_inst.Ref;
/// Instruction-emission handlers for `emitInst`: every opcode group — the
/// constant, arithmetic, bitwise, comparison, logical, memory, globals,
/// conversion, pointer, and call opcodes (direct/indirect/objc/jni dispatch
/// plus builtin, compiler, and closure calls), the aggregate ops (struct,
/// enum, union, array/slice, tuple, and optional), and the terminators,
/// box/unbox-Any, reflection, switch-branch, closure-creation, vector,
/// block-param, and misc ops. A backend `*LLVMEmitter` facade (field `e`):
/// each method emits one opcode's LLVM IR via `self.e.*`. The shared infra
/// these bodies call back into (`mapRef`/`resolveRef`/`advanceRefCounter`/
/// `getBlock`/`matchBinOpTypes`/`emitCmp`/`emitCmpOrdered`/`emitStrCmp`/
/// `emitStringConstant`/`reflection`/`emitConversion`/`coerceArg`/
/// `getRefIRType`/`loadJniFn`/`extractSlicePtr`/`emitJniConstructor`/
/// `emitFailableMainRet`/`emitFieldValueGet`/`resolveAggregate`/
/// `resolveGepStructType`) stays on `LLVMEmitter`. `emitInst`'s arms reach
/// these via `self.ops()`.
pub const Ops = struct {
e: *LLVMEmitter,
// ── Constants ───────────────────────────────────────────
pub fn emitConstInt(self: Ops, instruction: *const Inst, val: i64) void {
const ty = self.e.toLLVMType(instruction.ty);
const kind = c.LLVMGetTypeKind(ty);
const llvm_val = if (kind == c.LLVMIntegerTypeKind)
c.LLVMConstInt(ty, @bitCast(val), 1)
else if (kind == c.LLVMPointerTypeKind)
c.LLVMConstNull(ty)
else
// void or other non-integer type: emit i64 0 as unused placeholder
c.LLVMConstInt(c.LLVMInt64TypeInContext(self.e.context), 0, 0);
self.e.mapRef(llvm_val);
}
pub fn emitConstFloat(self: Ops, instruction: *const Inst, val: f64) void {
const ty = self.e.toLLVMType(instruction.ty);
const llvm_val = c.LLVMConstReal(ty, val);
self.e.mapRef(llvm_val);
}
pub fn emitConstBool(self: Ops, val: bool) void {
const llvm_val = c.LLVMConstInt(self.e.cached_i1, @intFromBool(val), 0);
self.e.mapRef(llvm_val);
}
pub fn emitIsComptime(self: Ops) void {
// Compiled code is never the comptime interpreter → constant
// `false`. A `if is_comptime() { … }` branch becomes dead.
self.e.mapRef(c.LLVMConstInt(self.e.cached_i1, 0, 0));
}
pub fn emitInterpPrintFrames(self: Ops) void {
// No interpreter stack in compiled code; this only ever sits in
// a dead `is_comptime()` branch. Emit nothing.
self.e.advanceRefCounter();
}
pub fn emitTraceFrame(self: Ops, instruction: *const Inst) void {
self.e.mapRef(self.e.reflection().emitTraceFrame(instruction));
}
pub fn emitTraceResolve(self: Ops, u: UnaryOp) void {
// The operand is a `Frame*` stamped in by `.trace_frame` (as
// i64); reinterpret and load it.
const raw = self.e.resolveRef(u.operand);
const frame_ty = self.e.getFrameStructType();
const ptr = c.LLVMBuildIntToPtr(self.e.builder, raw, self.e.cached_ptr, "frame.ptr");
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, frame_ty, ptr, "frame.val"));
}
pub fn emitConstString(self: Ops, str_id: StringId) void {
const str = self.e.ir_mod.types.getString(str_id);
const llvm_val = self.e.emitStringConstant(str);
self.e.mapRef(llvm_val);
}
pub fn emitConstNull(self: Ops, instruction: *const Inst) void {
const ty = if (instruction.ty == .void) self.e.cached_ptr else self.e.toLLVMType(instruction.ty);
const llvm_val = c.LLVMConstNull(ty);
self.e.mapRef(llvm_val);
}
pub fn emitConstUndef(self: Ops, instruction: *const Inst) void {
if (instruction.ty == .void) {
// void has no value — map to undef i64 as placeholder
self.e.mapRef(c.LLVMGetUndef(self.e.cached_i64));
} else {
const ty = self.e.toLLVMType(instruction.ty);
const llvm_val = c.LLVMGetUndef(ty);
self.e.mapRef(llvm_val);
}
}
pub fn emitConstType(self: Ops, tid: TypeId) void {
// Type values are Any-shaped pairs:
// { tag = .any.index() (the meta-marker),
// value = tid.index() }
// Lets storage in Any slots, struct fields,
// `Type`-typed vars, and slice elements all round-
// trip through the standard Any infrastructure.
// `case type:` in `any_to_string` matches on
// tag == `.any.index()`. Runtime `type_name(t)`
// extracts the value field and indexes into the
// type-name lookup table.
const any_ty = self.e.getAnyStructType();
const tag = c.LLVMConstInt(self.e.cached_i64, TypeId.any.index(), 0);
const val = c.LLVMConstInt(self.e.cached_i64, tid.index(), 0);
var result = c.LLVMGetUndef(any_ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, tag, 0, "ct.tag");
result = c.LLVMBuildInsertValue(self.e.builder, result, val, 1, "ct.val");
self.e.mapRef(result);
}
// ── Arithmetic ─────────────────────────────────────────
pub fn emitAdd(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
const is_float = emit.isFloatOrVecFloat(instruction.ty, &self.e.ir_mod.types);
const result = if (is_float)
c.LLVMBuildFAdd(self.e.builder, lhs, rhs, "fadd")
else
c.LLVMBuildAdd(self.e.builder, lhs, rhs, "add");
self.e.mapRef(result);
}
pub fn emitSub(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
const is_float = emit.isFloatOrVecFloat(instruction.ty, &self.e.ir_mod.types);
const result = if (is_float)
c.LLVMBuildFSub(self.e.builder, lhs, rhs, "fsub")
else
c.LLVMBuildSub(self.e.builder, lhs, rhs, "sub");
self.e.mapRef(result);
}
pub fn emitMul(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
const is_float = emit.isFloatOrVecFloat(instruction.ty, &self.e.ir_mod.types);
const result = if (is_float)
c.LLVMBuildFMul(self.e.builder, lhs, rhs, "fmul")
else
c.LLVMBuildMul(self.e.builder, lhs, rhs, "mul");
self.e.mapRef(result);
}
pub fn emitDiv(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
const is_float = emit.isFloatOrVecFloat(instruction.ty, &self.e.ir_mod.types);
const result = if (is_float)
c.LLVMBuildFDiv(self.e.builder, lhs, rhs, "fdiv")
else if (emit.isSignedType(instruction.ty))
c.LLVMBuildSDiv(self.e.builder, lhs, rhs, "sdiv")
else
c.LLVMBuildUDiv(self.e.builder, lhs, rhs, "udiv");
self.e.mapRef(result);
}
pub fn emitMod(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
const is_float = emit.isFloatOrVecFloat(instruction.ty, &self.e.ir_mod.types);
const result = if (is_float)
c.LLVMBuildFRem(self.e.builder, lhs, rhs, "fmod")
else if (emit.isSignedType(instruction.ty))
c.LLVMBuildSRem(self.e.builder, lhs, rhs, "srem")
else
c.LLVMBuildURem(self.e.builder, lhs, rhs, "urem");
self.e.mapRef(result);
}
pub fn emitNeg(self: Ops, instruction: *const Inst, un: UnaryOp) void {
const operand = self.e.resolveRef(un.operand);
const is_float = emit.isFloatOrVecFloat(instruction.ty, &self.e.ir_mod.types);
const result = if (is_float)
c.LLVMBuildFNeg(self.e.builder, operand, "fneg")
else
c.LLVMBuildNeg(self.e.builder, operand, "neg");
self.e.mapRef(result);
}
// ── Bitwise ────────────────────────────────────────────
pub fn emitBitAnd(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
self.e.mapRef(c.LLVMBuildAnd(self.e.builder, lhs, rhs, "and"));
}
pub fn emitBitOr(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
self.e.mapRef(c.LLVMBuildOr(self.e.builder, lhs, rhs, "or"));
}
pub fn emitBitXor(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
self.e.mapRef(c.LLVMBuildXor(self.e.builder, lhs, rhs, "xor"));
}
pub fn emitBitNot(self: Ops, un: UnaryOp) void {
const operand = self.e.resolveRef(un.operand);
self.e.mapRef(c.LLVMBuildNot(self.e.builder, operand, "not"));
}
pub fn emitShl(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
self.e.mapRef(c.LLVMBuildShl(self.e.builder, lhs, rhs, "shl"));
}
pub fn emitShr(self: Ops, instruction: *const Inst, bin: BinOp) void {
var lhs = self.e.resolveRef(bin.lhs);
var rhs = self.e.resolveRef(bin.rhs);
self.e.matchBinOpTypes(&lhs, &rhs, instruction.ty);
// Use arithmetic shift right for signed, logical for unsigned
const result = if (emit.isSignedType(instruction.ty))
c.LLVMBuildAShr(self.e.builder, lhs, rhs, "ashr")
else
c.LLVMBuildLShr(self.e.builder, lhs, rhs, "lshr");
self.e.mapRef(result);
}
// ── Comparisons ───────────────────────────────────────
pub fn emitCmpEq(self: Ops, instruction: *const Inst, bin: BinOp) void {
self.e.emitCmp(bin, instruction.ty, c.LLVMIntEQ, c.LLVMRealOEQ);
}
pub fn emitCmpNe(self: Ops, instruction: *const Inst, bin: BinOp) void {
// Float `!=` is UNORDERED not-equal: true if either operand is NaN, so
// `nan != nan` is true (IEEE 754 / the `x != x` NaN idiom) and `!=` stays
// the exact complement of `==` (OEQ). UNE == ONE for all non-NaN operands.
self.e.emitCmp(bin, instruction.ty, c.LLVMIntNE, c.LLVMRealUNE);
}
pub fn emitCmpLt(self: Ops, instruction: *const Inst, bin: BinOp) void {
self.e.emitCmpOrdered(bin, instruction.ty, c.LLVMIntSLT, c.LLVMIntULT, c.LLVMRealOLT);
}
pub fn emitCmpLe(self: Ops, instruction: *const Inst, bin: BinOp) void {
self.e.emitCmpOrdered(bin, instruction.ty, c.LLVMIntSLE, c.LLVMIntULE, c.LLVMRealOLE);
}
pub fn emitCmpGt(self: Ops, instruction: *const Inst, bin: BinOp) void {
self.e.emitCmpOrdered(bin, instruction.ty, c.LLVMIntSGT, c.LLVMIntUGT, c.LLVMRealOGT);
}
pub fn emitCmpGe(self: Ops, instruction: *const Inst, bin: BinOp) void {
self.e.emitCmpOrdered(bin, instruction.ty, c.LLVMIntSGE, c.LLVMIntUGE, c.LLVMRealOGE);
}
pub fn emitStrEq(self: Ops, bin: BinOp) void {
self.e.emitStrCmp(bin, true);
}
pub fn emitStrNe(self: Ops, bin: BinOp) void {
self.e.emitStrCmp(bin, false);
}
// ── Logical ───────────────────────────────────────────
pub fn emitBoolAnd(self: Ops, bin: BinOp) void {
const lhs = self.e.resolveRef(bin.lhs);
const rhs = self.e.resolveRef(bin.rhs);
self.e.mapRef(c.LLVMBuildAnd(self.e.builder, lhs, rhs, "land"));
}
pub fn emitBoolOr(self: Ops, bin: BinOp) void {
const lhs = self.e.resolveRef(bin.lhs);
const rhs = self.e.resolveRef(bin.rhs);
self.e.mapRef(c.LLVMBuildOr(self.e.builder, lhs, rhs, "lor"));
}
pub fn emitBoolNot(self: Ops, un: UnaryOp) void {
const operand = self.e.resolveRef(un.operand);
self.e.mapRef(c.LLVMBuildNot(self.e.builder, operand, "lnot"));
}
// ── Memory ────────────────────────────────────────────
pub fn emitAlloca(self: Ops, elem_ty: TypeId) void {
const llvm_ty = self.e.toLLVMType(elem_ty);
const result = self.e.buildEntryAlloca(llvm_ty, "alloca");
self.e.mapRef(result);
}
pub fn emitLoad(self: Ops, instruction: *const Inst, un: UnaryOp) void {
const ptr = self.e.resolveRef(un.operand);
const ptr_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(ptr));
if (ptr_kind == c.LLVMPointerTypeKind and instruction.ty != .void) {
const llvm_ty = self.e.toLLVMType(instruction.ty);
const result = c.LLVMBuildLoad2(self.e.builder, llvm_ty, ptr, "load");
self.e.mapRef(result);
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(if (instruction.ty == .void) .i64 else instruction.ty)));
}
}
pub fn emitStore(self: Ops, st: Store) void {
const ptr = self.e.resolveRef(st.ptr);
var val = self.e.resolveRef(st.val);
// Guard: don't store void types or store to non-pointer
const ptr_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(ptr));
const val_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(val));
if (ptr_kind == c.LLVMPointerTypeKind and val_kind != c.LLVMVoidTypeKind) {
// Coerce value to match the IR-declared pointer target type.
// E.g. storing i64 to *i8 (from index_gep on string) needs truncation.
//
// Only unwrap .pointer (from index_gep/alloca: *element → element).
// Never unwrap .many_pointer — it only appears as struct_gep field
// value types (e.g., [*]BigNode), where unwrapping to the element
// type gives a wrong store size (stores BigNode-sized instead of ptr).
if (self.e.getRefIRType(st.ptr)) |ptr_ir_ty| {
const pointee_info = self.e.ir_mod.types.get(ptr_ir_ty);
const target_ty: ?c.LLVMTypeRef = switch (pointee_info) {
.pointer => |p| self.e.toLLVMType(p.pointee),
else => null,
};
if (target_ty) |tt| {
val = self.e.coerceArg(val, tt);
}
}
_ = c.LLVMBuildStore(self.e.builder, val, ptr);
}
self.e.advanceRefCounter();
}
// ── Globals ───────────────────────────────────────────
pub fn emitGlobalGet(self: Ops, instruction: *const Inst, gid: GlobalId) void {
const llvm_global = self.e.global_map.get(gid.index()) orelse {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
return;
};
const llvm_ty = self.e.toLLVMType(instruction.ty);
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, llvm_ty, llvm_global, "gload"));
}
pub fn emitGlobalAddr(self: Ops, gid: GlobalId) void {
const llvm_global = self.e.global_map.get(gid.index()) orelse {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_ptr));
return;
};
// Return the global's address directly (no load)
self.e.mapRef(llvm_global);
}
pub fn emitFuncRef(self: Ops, fid: FuncId) void {
// Produce a reference to the function as a function pointer value
if (self.e.func_map.get(@intFromEnum(fid))) |llvm_func| {
self.e.mapRef(llvm_func);
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_ptr));
}
}
pub fn emitGlobalSet(self: Ops, gs: GlobalSet) void {
const llvm_global = self.e.global_map.get(gs.global.index()) orelse {
self.e.advanceRefCounter();
return;
};
const val = self.e.resolveRef(gs.value);
_ = c.LLVMBuildStore(self.e.builder, val, llvm_global);
self.e.advanceRefCounter();
}
// ── Conversions ───────────────────────────────────────
pub fn emitWiden(self: Ops, conv: Conversion) void {
const operand = self.e.resolveRef(conv.operand);
const to_ty = self.e.toLLVMType(conv.to);
const result = self.e.emitConversion(operand, conv.from, conv.to, to_ty);
self.e.mapRef(result);
}
pub fn emitNarrow(self: Ops, conv: Conversion) void {
const operand = self.e.resolveRef(conv.operand);
const to_ty = self.e.toLLVMType(conv.to);
const result = self.e.emitConversion(operand, conv.from, conv.to, to_ty);
self.e.mapRef(result);
}
pub fn emitBitcast(self: Ops, conv: Conversion) void {
const operand = self.e.resolveRef(conv.operand);
const to_ty = self.e.toLLVMType(conv.to);
// LLVMBuildBitCast doesn't accept ptr↔int on modern
// LLVM. Dispatch to PtrToInt / IntToPtr when needed —
// lower.zig emits a `bitcast` IR op for both shapes.
const from_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(operand));
const to_kind = c.LLVMGetTypeKind(to_ty);
if (from_kind == c.LLVMPointerTypeKind and to_kind == c.LLVMIntegerTypeKind) {
const i64_val = c.LLVMBuildPtrToInt(self.e.builder, operand, self.e.cached_i64, "pti");
const w = c.LLVMGetIntTypeWidth(to_ty);
if (w == 64) {
self.e.mapRef(i64_val);
} else if (w < 64) {
self.e.mapRef(c.LLVMBuildTrunc(self.e.builder, i64_val, to_ty, "pti.tr"));
} else {
self.e.mapRef(c.LLVMBuildZExt(self.e.builder, i64_val, to_ty, "pti.ext"));
}
} else if (from_kind == c.LLVMIntegerTypeKind and to_kind == c.LLVMPointerTypeKind) {
self.e.mapRef(c.LLVMBuildIntToPtr(self.e.builder, operand, to_ty, "itp"));
} else {
self.e.mapRef(c.LLVMBuildBitCast(self.e.builder, operand, to_ty, "bitcast"));
}
}
pub fn emitIntToFloat(self: Ops, conv: Conversion) void {
const operand = self.e.resolveRef(conv.operand);
const to_ty = self.e.toLLVMType(conv.to);
const result = if (emit.isSignedType(conv.from))
c.LLVMBuildSIToFP(self.e.builder, operand, to_ty, "sitofp")
else
c.LLVMBuildUIToFP(self.e.builder, operand, to_ty, "uitofp");
self.e.mapRef(result);
}
pub fn emitFloatToInt(self: Ops, conv: Conversion) void {
const operand = self.e.resolveRef(conv.operand);
const to_ty = self.e.toLLVMType(conv.to);
const result = if (emit.isSignedType(conv.to))
c.LLVMBuildFPToSI(self.e.builder, operand, to_ty, "fptosi")
else
c.LLVMBuildFPToUI(self.e.builder, operand, to_ty, "fptoui");
self.e.mapRef(result);
}
// ── Pointer ops ───────────────────────────────────────
pub fn emitAddrOf(self: Ops, un: UnaryOp) void {
// addr_of returns the pointer directly (the operand is already a ptr from alloca)
self.e.mapRef(self.e.resolveRef(un.operand));
}
pub fn emitDeref(self: Ops, instruction: *const Inst, un: UnaryOp) void {
const ptr = self.e.resolveRef(un.operand);
const llvm_ty = self.e.toLLVMType(instruction.ty);
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, llvm_ty, ptr, "deref"));
}
// ── Calls ─────────────────────────────────────────────
pub fn emitObjcMsgSend(self: Ops, instruction: *const Inst, msg: ObjcMsgSend) void {
const msg_send = self.e.getObjcMsgSendValue();
// Detect the sret case: >16 B non-HFA struct return.
// Same predicate as the plain-foreign-call path so the
// two arms stay in lockstep.
const raw_ret_ty = self.e.toLLVMType(instruction.ty);
const uses_sret = self.e.needsByval(instruction.ty, raw_ret_ty);
const ret_ty = if (uses_sret) self.e.cached_void else raw_ret_ty;
// Slot layout:
// uses_sret = false → [recv, sel, args...]
// uses_sret = true → [sret_slot, recv, sel, args...]
const sret_off: usize = if (uses_sret) 1 else 0;
const total_params: usize = 2 + msg.args.len + sret_off;
const param_types = self.e.alloc.alloc(c.LLVMTypeRef, total_params) catch unreachable;
defer self.e.alloc.free(param_types);
const call_args = self.e.alloc.alloc(c.LLVMValueRef, total_params) catch unreachable;
defer self.e.alloc.free(call_args);
var sret_slot: c.LLVMValueRef = null;
if (uses_sret) {
sret_slot = self.e.buildEntryAlloca(raw_ret_ty, "objc.sret");
param_types[0] = self.e.cached_ptr;
call_args[0] = sret_slot;
}
// recv (typed *void from the IR)
param_types[sret_off] = self.e.cached_ptr;
call_args[sret_off] = self.e.coerceArg(self.e.resolveRef(msg.recv), self.e.cached_ptr);
// sel (loaded SEL — opaque ptr)
param_types[sret_off + 1] = self.e.cached_ptr;
call_args[sret_off + 1] = self.e.coerceArg(self.e.resolveRef(msg.sel), self.e.cached_ptr);
// additional args take their IR types, with ABI
// coercion applied so structs / strings decay the
// same way they do for any C foreign call.
for (msg.args, 0..) |arg_ref, i| {
const raw_ty = self.e.argIRTypeOrFail(arg_ref);
const raw_llvm = self.e.toLLVMType(raw_ty);
const coerced_ty = self.e.abiCoerceParamType(raw_ty, raw_llvm);
param_types[i + 2 + sret_off] = coerced_ty;
call_args[i + 2 + sret_off] = self.e.coerceArg(self.e.resolveRef(arg_ref), coerced_ty);
}
const fn_ty = c.LLVMFunctionType(ret_ty, param_types.ptr, @intCast(total_params), 0);
const call_label: [*:0]const u8 = if (instruction.ty == .void or uses_sret) "" else "objc.msg";
var result = c.LLVMBuildCall2(self.e.builder, fn_ty, msg_send, call_args.ptr, @intCast(total_params), call_label);
if (uses_sret) {
// Tag the call's arg 0 (sret slot) with the sret
// attribute so the AArch64 / SysV backends route
// through the x8 / hidden-pointer convention.
const sret_kind = c.LLVMGetEnumAttributeKindForName("sret", 4);
const sret_attr = c.LLVMCreateTypeAttribute(self.e.context, sret_kind, raw_ret_ty);
const param1_idx: c.LLVMAttributeIndex = @bitCast(@as(i32, 1));
c.LLVMAddCallSiteAttribute(result, param1_idx, sret_attr);
result = c.LLVMBuildLoad2(self.e.builder, raw_ret_ty, sret_slot, "objc.sret.load");
}
// Always mapRef — the IR Ref counter for this
// instruction advances regardless of return type,
// so skipping it would misalign every subsequent
// ref lookup in this function.
self.e.mapRef(result);
}
pub fn emitJniMsgSend(self: Ops, instruction: *const Inst, msg: JniMsgSend) void {
// JNI vtable indirection:
// ifs = *env // JNINativeInterface*
// instance: cls = ifs[GetObjectClass](env, target)
// mid = ifs[GetMethodID](env, cls, name, sig)
// ifs[Call<T>Method](env, target, mid, args...)
// static: target IS the jclass — skip GetObjectClass
// mid = ifs[GetStaticMethodID](env, target, name, sig)
// ifs[CallStatic<T>Method](env, target, mid, args...)
// ctor: cls = ifs[FindClass](env, parent_class_path)
// mid = ifs[GetMethodID](env, cls, "<init>", sig)
// ifs[NewObject](env, cls, mid, args...) → jobject
// nonvirt: handled below via FindClass + GetMethodID +
// CallNonvirtual<T>Method.
// The cached path (msg.cache_key != null) still shares one
// (jclass GlobalRef, jmethodID) pair per literal (name, sig).
if (msg.is_constructor) {
self.e.emitJniConstructor(msg, instruction.ty);
return;
}
const ret_ty_id = instruction.ty;
const is_pointer_ret = switch (self.e.ir_mod.types.get(ret_ty_id)) {
.pointer, .many_pointer => true,
else => false,
};
const call_method_offset: u32 = if (msg.is_static) blk: {
if (is_pointer_ret) break :blk emit.Jni.CallStaticObjectMethod;
break :blk switch (ret_ty_id) {
.void => emit.Jni.CallStaticVoidMethod,
.i32 => emit.Jni.CallStaticIntMethod,
.i64 => emit.Jni.CallStaticLongMethod,
.f32 => emit.Jni.CallStaticFloatMethod,
.f64 => emit.Jni.CallStaticDoubleMethod,
.bool => emit.Jni.CallStaticBooleanMethod,
else => {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
return;
},
};
} else if (msg.is_nonvirtual) blk: {
if (is_pointer_ret) break :blk emit.Jni.CallNonvirtualObjectMethod;
break :blk switch (ret_ty_id) {
.void => emit.Jni.CallNonvirtualVoidMethod,
.i32 => emit.Jni.CallNonvirtualIntMethod,
.i64 => emit.Jni.CallNonvirtualLongMethod,
.f32 => emit.Jni.CallNonvirtualFloatMethod,
.f64 => emit.Jni.CallNonvirtualDoubleMethod,
.bool => emit.Jni.CallNonvirtualBooleanMethod,
else => {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
return;
},
};
} else blk: {
if (is_pointer_ret) break :blk emit.Jni.CallObjectMethod;
break :blk switch (ret_ty_id) {
.void => emit.Jni.CallVoidMethod,
.i32 => emit.Jni.CallIntMethod,
.i64 => emit.Jni.CallLongMethod,
.f32 => emit.Jni.CallFloatMethod,
.f64 => emit.Jni.CallDoubleMethod,
.bool => emit.Jni.CallBooleanMethod,
else => {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
return;
},
};
};
const get_mid_offset: u32 = if (msg.is_static) emit.Jni.GetStaticMethodID else emit.Jni.GetMethodID;
const env = self.e.resolveRef(msg.env);
const target = self.e.resolveRef(msg.target);
// String literals lower as `{ptr, i64}` slices in sx IR;
// JNI's `GetMethodID` expects raw C strings, so extract
// field 0 when the source is a slice.
const name_ptr = self.e.extractSlicePtr(self.e.resolveRef(msg.name));
const sig_ptr = self.e.extractSlicePtr(self.e.resolveRef(msg.sig));
const ifs = c.LLVMBuildLoad2(self.e.builder, self.e.cached_ptr, env, "jni.ifs");
// Method-ID resolution. When `name` and `sig` are both
// string literals the call site participates in
// `(name, sig)` slot interning (step 1.17): a shared
// pair of static globals holds the `jclass` GlobalRef
// and the `jmethodID`, populated lazily on the first
// call to any matching site. Non-literal sites fall
// back to the per-call `GetObjectClass + GetMethodID`
// sequence (1.15 shape).
const mid = if (msg.cache_key) |ck| blk: {
const pair = self.e.ffiCtors().getOrCreateJniSlots(ck.name_str, ck.sig_str);
const cached_mid = c.LLVMBuildLoad2(self.e.builder, self.e.cached_ptr, pair.mid_slot, "jni.cached.mid");
const is_cached = c.LLVMBuildICmp(self.e.builder, c.LLVMIntNE, cached_mid, c.LLVMConstNull(self.e.cached_ptr), "jni.is.cached");
const cur_fn = c.LLVMGetBasicBlockParent(c.LLVMGetInsertBlock(self.e.builder));
const miss_bb = c.LLVMAppendBasicBlockInContext(self.e.context, cur_fn, "jni.miss");
const cont_bb = c.LLVMAppendBasicBlockInContext(self.e.context, cur_fn, "jni.cont");
const before_bb = c.LLVMGetInsertBlock(self.e.builder);
_ = c.LLVMBuildCondBr(self.e.builder, is_cached, cont_bb, miss_bb);
// Miss path:
// instance: GetObjectClass → NewGlobalRef → GetMethodID
// static: target IS class → NewGlobalRef(target) → GetStaticMethodID
c.LLVMPositionBuilderAtEnd(self.e.builder, miss_bb);
const local_cls = if (msg.is_static) target else inst_cls: {
const get_obj_cls = self.e.loadJniFn(ifs, emit.Jni.GetObjectClass, "jni.GetObjectClass");
var gocls_params = [_]c.LLVMTypeRef{ self.e.cached_ptr, self.e.cached_ptr };
const gocls_ty = c.LLVMFunctionType(self.e.cached_ptr, &gocls_params, 2, 0);
var gocls_args = [_]c.LLVMValueRef{ env, target };
break :inst_cls c.LLVMBuildCall2(self.e.builder, gocls_ty, get_obj_cls, &gocls_args, 2, "jni.cls");
};
const new_global_ref = self.e.loadJniFn(ifs, emit.Jni.NewGlobalRef, "jni.NewGlobalRef");
var ngref_params = [_]c.LLVMTypeRef{ self.e.cached_ptr, self.e.cached_ptr };
const ngref_ty = c.LLVMFunctionType(self.e.cached_ptr, &ngref_params, 2, 0);
var ngref_args = [_]c.LLVMValueRef{ env, local_cls };
const global_cls = c.LLVMBuildCall2(self.e.builder, ngref_ty, new_global_ref, &ngref_args, 2, "jni.global.cls");
_ = c.LLVMBuildStore(self.e.builder, global_cls, pair.cls_slot);
const get_mid = self.e.loadJniFn(ifs, get_mid_offset, if (msg.is_static) "jni.GetStaticMethodID" else "jni.GetMethodID");
var gmid_params = [_]c.LLVMTypeRef{ self.e.cached_ptr, self.e.cached_ptr, self.e.cached_ptr, self.e.cached_ptr };
const gmid_ty = c.LLVMFunctionType(self.e.cached_ptr, &gmid_params, 4, 0);
var gmid_args = [_]c.LLVMValueRef{ env, global_cls, name_ptr, sig_ptr };
const fresh_mid = c.LLVMBuildCall2(self.e.builder, gmid_ty, get_mid, &gmid_args, 4, "jni.fresh.mid");
_ = c.LLVMBuildStore(self.e.builder, fresh_mid, pair.mid_slot);
const miss_end_bb = c.LLVMGetInsertBlock(self.e.builder);
_ = c.LLVMBuildBr(self.e.builder, cont_bb);
// Cont: phi the cached vs fresh mid.
c.LLVMPositionBuilderAtEnd(self.e.builder, cont_bb);
const phi = c.LLVMBuildPhi(self.e.builder, self.e.cached_ptr, "jni.mid");
var phi_vals = [_]c.LLVMValueRef{ cached_mid, fresh_mid };
var phi_blocks = [_]c.LLVMBasicBlockRef{ before_bb, miss_end_bb };
c.LLVMAddIncoming(phi, &phi_vals, &phi_blocks, 2);
break :blk phi;
} else blk: {
const cls = if (msg.is_static) target else if (msg.is_nonvirtual) nonvirt_cls: {
// `super.method(args)`: dispatch is bound to a
// specific class (the parent), not subclass-override.
// Resolve via FindClass(parent_path). No caching yet —
// per-call lookup. The parent path is a NUL-terminated
// C string emitted as a private LLVM global.
const path = msg.parent_class_path orelse "";
const path_global = self.e.emitCStringGlobal(path, "jni.parent.path");
const find_class = self.e.loadJniFn(ifs, emit.Jni.FindClass, "jni.FindClass");
var fc_params = [_]c.LLVMTypeRef{ self.e.cached_ptr, self.e.cached_ptr };
const fc_ty = c.LLVMFunctionType(self.e.cached_ptr, &fc_params, 2, 0);
var fc_args = [_]c.LLVMValueRef{ env, path_global };
break :nonvirt_cls c.LLVMBuildCall2(self.e.builder, fc_ty, find_class, &fc_args, 2, "jni.parent.cls");
} else inst_cls: {
const get_obj_cls = self.e.loadJniFn(ifs, emit.Jni.GetObjectClass, "jni.GetObjectClass");
var gocls_params = [_]c.LLVMTypeRef{ self.e.cached_ptr, self.e.cached_ptr };
const gocls_ty = c.LLVMFunctionType(self.e.cached_ptr, &gocls_params, 2, 0);
var gocls_args = [_]c.LLVMValueRef{ env, target };
break :inst_cls c.LLVMBuildCall2(self.e.builder, gocls_ty, get_obj_cls, &gocls_args, 2, "jni.cls");
};
const get_mid = self.e.loadJniFn(ifs, get_mid_offset, if (msg.is_static) "jni.GetStaticMethodID" else "jni.GetMethodID");
var gmid_params = [_]c.LLVMTypeRef{ self.e.cached_ptr, self.e.cached_ptr, self.e.cached_ptr, self.e.cached_ptr };
const gmid_ty = c.LLVMFunctionType(self.e.cached_ptr, &gmid_params, 4, 0);
var gmid_args = [_]c.LLVMValueRef{ env, cls, name_ptr, sig_ptr };
const mid_val = c.LLVMBuildCall2(self.e.builder, gmid_ty, get_mid, &gmid_args, 4, "jni.mid");
if (msg.is_nonvirtual) {
// Stash cls in a dummy slot so the call site below
// can pick it up. Easiest path: do the call right
// here and return Ref.none, but we need to keep the
// outer phi shape. Instead, return both via tuple
// through an auxiliary local — simplest is to attach
// `cls` to a per-invocation slot. Use a stack alloca.
const cls_slot = self.e.buildEntryAlloca(self.e.cached_ptr, "jni.parent.cls.slot");
_ = c.LLVMBuildStore(self.e.builder, cls, cls_slot);
// Tag the slot pointer onto the phi result via the
// generated metadata: we'll re-extract by re-running
// FindClass — actually simpler: lower nonvirtual on
// the spot below. Drop the implicit `break` here:
const call_fn = self.e.loadJniFn(ifs, call_method_offset, "jni.callfn.nonvirtual");
const raw_ret = self.e.toLLVMType(ret_ty_id);
const total_call_params_nv: usize = 4 + msg.args.len;
const call_param_types_nv = self.e.alloc.alloc(c.LLVMTypeRef, total_call_params_nv) catch unreachable;
defer self.e.alloc.free(call_param_types_nv);
const call_args_nv = self.e.alloc.alloc(c.LLVMValueRef, total_call_params_nv) catch unreachable;
defer self.e.alloc.free(call_args_nv);
call_param_types_nv[0] = self.e.cached_ptr;
call_param_types_nv[1] = self.e.cached_ptr;
call_param_types_nv[2] = self.e.cached_ptr;
call_param_types_nv[3] = self.e.cached_ptr;
call_args_nv[0] = env;
call_args_nv[1] = target;
call_args_nv[2] = cls;
call_args_nv[3] = mid_val;
for (msg.args, 0..) |arg_ref, i| {
const raw_ty = self.e.argIRTypeOrFail(arg_ref);
const raw_llvm = self.e.toLLVMType(raw_ty);
const coerced_ty = self.e.abiCoerceParamType(raw_ty, raw_llvm);
call_param_types_nv[i + 4] = coerced_ty;
call_args_nv[i + 4] = self.e.coerceArg(self.e.resolveRef(arg_ref), coerced_ty);
}
const call_fn_ty_nv = c.LLVMFunctionType(raw_ret, call_param_types_nv.ptr, @intCast(total_call_params_nv), 0);
const label_nv: [*:0]const u8 = if (ret_ty_id == .void) "" else "jni.nonvirtual.ret";
const result_nv = c.LLVMBuildCall2(self.e.builder, call_fn_ty_nv, call_fn, call_args_nv.ptr, @intCast(total_call_params_nv), label_nv);
self.e.mapRef(result_nv);
return;
}
break :blk mid_val;
};
// Call<Type>Method: (JNIEnv*, jobject, jmethodID, args...) -> RetTy
const call_fn = self.e.loadJniFn(ifs, call_method_offset, "jni.callfn");
const raw_ret = self.e.toLLVMType(ret_ty_id);
const total_call_params: usize = 3 + msg.args.len;
const call_param_types = self.e.alloc.alloc(c.LLVMTypeRef, total_call_params) catch unreachable;
defer self.e.alloc.free(call_param_types);
const call_args = self.e.alloc.alloc(c.LLVMValueRef, total_call_params) catch unreachable;
defer self.e.alloc.free(call_args);
call_param_types[0] = self.e.cached_ptr;
call_param_types[1] = self.e.cached_ptr;
call_param_types[2] = self.e.cached_ptr;
call_args[0] = env;
call_args[1] = target;
call_args[2] = mid;
for (msg.args, 0..) |arg_ref, i| {
const raw_ty = self.e.argIRTypeOrFail(arg_ref);
const raw_llvm = self.e.toLLVMType(raw_ty);
const coerced_ty = self.e.abiCoerceParamType(raw_ty, raw_llvm);
call_param_types[i + 3] = coerced_ty;
call_args[i + 3] = self.e.coerceArg(self.e.resolveRef(arg_ref), coerced_ty);
}
const call_fn_ty = c.LLVMFunctionType(raw_ret, call_param_types.ptr, @intCast(total_call_params), 0);
const label: [*:0]const u8 = if (ret_ty_id == .void) "" else "jni.ret";
const result = c.LLVMBuildCall2(self.e.builder, call_fn_ty, call_fn, call_args.ptr, @intCast(total_call_params), label);
self.e.mapRef(result);
}
pub fn emitCall(self: Ops, instruction: *const Inst, call_op: Call) void {
// Evaluate comptime functions at compile time
const callee_func = &self.e.ir_mod.functions.items[call_op.callee.index()];
if (callee_func.is_comptime and call_op.args.len == 0) {
var interp_inst = Interpreter.init(self.e.ir_mod, self.e.alloc);
interp_inst.build_config = &self.e.build_config;
if (self.e.import_sources) |sm| interp_inst.setSourceMap(sm);
defer interp_inst.deinit();
if (interp_inst.call(call_op.callee, &.{})) |result| {
if (result.asInt()) |v| {
self.e.mapRef(c.LLVMConstInt(self.e.toLLVMType(instruction.ty), @bitCast(v), 0));
return;
} else if (result.asFloat()) |v| {
self.e.mapRef(c.LLVMConstReal(self.e.toLLVMType(instruction.ty), v));
return;
} else if (result.asBool()) |v| {
self.e.mapRef(c.LLVMConstInt(self.e.toLLVMType(instruction.ty), @intFromBool(v), 0));
return;
} else if (result == .string) {
self.e.mapRef(self.e.emitStringConstant(result.string));
return;
}
} else |_| {}
}
const callee = self.e.func_map.get(call_op.callee.index()) orelse {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
return;
};
const callee_needs_c_abi = callee_func.is_extern or callee_func.call_conv == .c;
const callee_raw_ret = self.e.toLLVMType(callee_func.ret);
// Foreign string/?string returns receive one `char *` — never sret
// (must mirror declareFunction's signature classification).
const cstr_ret = self.e.cstrRetKind(callee_func);
const callee_uses_sret = callee_needs_c_abi and cstr_ret == .none and self.e.needsByval(callee_func.ret, callee_raw_ret);
// When the callee uses sret, prepend an alloca for the result.
// Index alignment: actual_args[0] = sret_slot; actual_args[i+1] = sx arg i.
const sret_off: usize = if (callee_uses_sret) 1 else 0;
const total_args = call_op.args.len + sret_off;
const args = self.e.alloc.alloc(c.LLVMValueRef, total_args) catch unreachable;
defer self.e.alloc.free(args);
var sret_slot: c.LLVMValueRef = null;
if (callee_uses_sret) {
sret_slot = self.e.buildEntryAlloca(callee_raw_ret, "sret.slot");
args[0] = sret_slot;
}
for (call_op.args, 0..) |arg_ref, j| {
args[j + sret_off] = self.e.resolveRef(arg_ref);
}
const arg_count: c_uint = @intCast(total_args);
// Get the function type from LLVM and coerce arguments
const fn_ty = c.LLVMGlobalGetValueType(callee);
const param_count = c.LLVMCountParamTypes(fn_ty);
if (param_count > 0) {
const param_types = self.e.alloc.alloc(c.LLVMTypeRef, param_count) catch unreachable;
defer self.e.alloc.free(param_types);
c.LLVMGetParamTypes(fn_ty, param_types.ptr);
for (0..@min(args.len, param_count)) |j| {
// The sret slot is already a properly-typed pointer; skip coercion.
if (callee_uses_sret and j == 0) continue;
const fn_param_idx = j - sret_off;
// Materialize byval args before coercion so we pass a ptr instead of the struct value.
if (callee_needs_c_abi and fn_param_idx < callee_func.params.len) {
const ir_ty = callee_func.params[fn_param_idx].ty;
const raw_struct = self.e.toLLVMType(ir_ty);
if (self.e.needsByval(ir_ty, raw_struct)) {
args[j] = self.e.materializeByvalArg(args[j], raw_struct);
continue;
}
}
args[j] = self.e.coerceArg(args[j], param_types[j]);
}
}
// A `void`/`noreturn` call has no value, so it must stay
// unnamed (LLVM rejects a named void result).
const call_is_void_like = instruction.ty == .void or instruction.ty == .noreturn;
const call_label: [*:0]const u8 = if (call_is_void_like or callee_uses_sret) "" else "call";
var result = c.LLVMBuildCall2(self.e.builder, fn_ty, callee, args.ptr, arg_count, call_label);
if (callee_uses_sret) {
// Mirror the function-decl `sret(<T>)` attribute on the call site so the
// LLVM backend lowers arg 0 via x8 (AAPCS64) / hidden ptr (SysV AMD64).
const sret_kind = c.LLVMGetEnumAttributeKindForName("sret", 4);
const sret_attr = c.LLVMCreateTypeAttribute(self.e.context, sret_kind, callee_raw_ret);
const param1_idx: c.LLVMAttributeIndex = @bitCast(@as(i32, 1));
c.LLVMAddCallSiteAttribute(result, param1_idx, sret_attr);
// Load the actual struct value the callee wrote into the slot.
result = c.LLVMBuildLoad2(self.e.builder, callee_raw_ret, sret_slot, "sret.load");
} else if (!call_is_void_like and cstr_ret != .none) {
// The C side returned `char *`; build the fat sx string (and the
// optional wrapper) from it.
result = self.e.cstrReturnToSx(result, cstr_ret == .optional);
} else if (!call_is_void_like and callee_func.is_extern) {
// Coerce ABI return value (e.g. i64 / [2 x i64]) back to IR struct type if needed
const expected_ty = self.e.toLLVMType(instruction.ty);
result = self.e.coerceArg(result, expected_ty);
}
self.e.mapRef(result);
}
pub fn emitCallIndirect(self: Ops, instruction: *const Inst, call_op: CallIndirect) void {
const callee = self.e.resolveRef(call_op.callee);
const arg_count: c_uint = @intCast(call_op.args.len);
const args = self.e.alloc.alloc(c.LLVMValueRef, call_op.args.len) catch unreachable;
defer self.e.alloc.free(args);
for (call_op.args, 0..) |arg_ref, j| {
args[j] = self.e.resolveRef(arg_ref);
}
// Get callee's IR type to resolve parameter types accurately
const callee_ir_ty = self.e.getRefIRType(call_op.callee);
const fn_params: ?[]const TypeId = if (callee_ir_ty) |cty| blk: {
if (!cty.isBuiltin()) {
const ci = self.e.ir_mod.types.get(cty);
switch (ci) {
.function => |f| break :blk f.params,
.closure => |cl| break :blk cl.params,
else => {},
}
}
break :blk null;
} else null;
// Read the fn-pointer type's calling convention. Only `.c` opts
// into the C-ABI byval coercion for >16B aggregate params.
const fp_is_c_abi: bool = if (callee_ir_ty) |cty| blk: {
if (!cty.isBuiltin()) {
const ci = self.e.ir_mod.types.get(cty);
if (ci == .function and ci.function.call_conv == .c) break :blk true;
}
break :blk false;
} else false;
// Default-conv fn-pointers under implicit-ctx carry a hidden
// `*void` (the implicit __sx_ctx) at LLVM slot 0. The IR fn
// type does not include it, so shift fn_params lookups by 1.
const fp_ctx_slots: usize = if (callee_ir_ty) |cty| blk: {
if (!self.e.ir_mod.has_implicit_ctx) break :blk 0;
if (cty.isBuiltin()) break :blk 0;
const ci = self.e.ir_mod.types.get(cty);
switch (ci) {
.function => |f| break :blk if (f.call_conv == .c) @as(usize, 0) else 1,
else => break :blk 0,
}
} else 0;
const ret_ty = if (callee_ir_ty) |cty| blk: {
if (!cty.isBuiltin()) {
const ci = self.e.ir_mod.types.get(cty);
switch (ci) {
.function => |f| break :blk self.e.toLLVMType(f.ret),
.closure => |cl| break :blk self.e.toLLVMType(cl.ret),
else => {},
}
}
break :blk self.e.toLLVMType(instruction.ty);
} else self.e.toLLVMType(instruction.ty);
const param_tys = self.e.alloc.alloc(c.LLVMTypeRef, call_op.args.len) catch unreachable;
defer self.e.alloc.free(param_tys);
if (fn_params) |fp| {
for (0..call_op.args.len) |j| {
// Slots 0..fp_ctx_slots are the implicit __sx_ctx
// (passed as opaque ptr; not in fp).
if (j < fp_ctx_slots) {
param_tys[j] = self.e.cached_ptr;
args[j] = self.e.coerceArg(args[j], self.e.cached_ptr);
continue;
}
const fp_idx = j - fp_ctx_slots;
if (fp_idx < fp.len) {
const raw_struct = self.e.toLLVMType(fp[fp_idx]);
if (fp_is_c_abi and self.e.needsByval(fp[fp_idx], raw_struct)) {
args[j] = self.e.materializeByvalArg(args[j], raw_struct);
param_tys[j] = self.e.cached_ptr;
continue;
}
var llvm_pty = raw_struct;
// Array params in fn-ptr calls decay to pointers (C ABI)
if (c.LLVMGetTypeKind(llvm_pty) == c.LLVMArrayTypeKind) {
llvm_pty = self.e.cached_ptr;
}
param_tys[j] = llvm_pty;
args[j] = self.e.coerceArg(args[j], llvm_pty);
} else {
param_tys[j] = c.LLVMTypeOf(args[j]);
}
}
} else {
for (args, 0..) |arg, j| {
param_tys[j] = c.LLVMTypeOf(arg);
}
}
const fn_ty = c.LLVMFunctionType(ret_ty, param_tys.ptr, arg_count, 0);
const icall_void_like = instruction.ty == .void or instruction.ty == .noreturn;
var result = c.LLVMBuildCall2(self.e.builder, fn_ty, callee, args.ptr, arg_count, if (icall_void_like) "" else "icall");
// Coerce call result to instruction's expected type
const expected_ty = self.e.toLLVMType(instruction.ty);
if (!icall_void_like and c.LLVMTypeOf(result) != expected_ty) {
result = self.e.coerceArg(result, expected_ty);
}
self.e.mapRef(result);
}
// ── Call extensions ───────────────────────────────────────
/// Resolve the `TypeId` (as a runtime `i64`) that a dynamic
/// `type_name` / `type_is_unsigned` must operate on. A reflection
/// builtin reads an `Any`'s runtime TYPE-TAG, never its raw payload:
/// - `.bare`: a `Type` value already lowered to a bare i64 `TypeId`
/// index (an unboxed direct call site) → the value itself.
/// - `.boxed`: an `Any` aggregate `{ tag, value }`. When the tag is
/// `.any`, the box carries a *Type value* (the `{ .any, tid }` shape
/// `const_type` / `type_of` produce) → the TypeId is the payload.
/// Otherwise the box carries a *runtime value* whose type IS the tag
/// → use the tag as the TypeId. This is what makes `type_name(av)`
/// for `av : Any = 6` report `i64` (the held value's type), while
/// `type_name(type_of(x))` still names the held type.
/// `.unresolved` is a hard tripwire: a type-resolution failure reached
/// emission without a diagnostic.
fn reflectArgTypeId(self: Ops, arg_ref: Ref, comptime label: []const u8) c.LLVMValueRef {
const arg_val = self.e.resolveRef(arg_ref);
return switch (self.e.reflectArgRepr(arg_ref)) {
.unresolved => @panic(label ++ ": reflection arg IR-type unresolved — a type-resolution failure reached LLVM emission without a diagnostic"),
.bare => arg_val,
.boxed => blk: {
const tag = c.LLVMBuildExtractValue(self.e.builder, arg_val, 0, "refl.tag");
const payload = c.LLVMBuildExtractValue(self.e.builder, arg_val, 1, "refl.val");
const any_tag = c.LLVMConstInt(self.e.cached_i64, @intCast(TypeId.any.index()), 0);
const holds_type = c.LLVMBuildICmp(self.e.builder, c.LLVMIntEQ, tag, any_tag, "refl.istype");
break :blk c.LLVMBuildSelect(self.e.builder, holds_type, payload, tag, "refl.tid");
},
};
}
pub fn emitCallBuiltin(self: Ops, instruction: *const Inst, bi: BuiltinCall) void {
// Builtins that map to libc functions or LLVM intrinsics
switch (bi.builtin) {
.sqrt, .sin, .cos, .floor => {
const val = self.e.resolveRef(bi.args[0]);
const val_ty = c.LLVMTypeOf(val);
const val_kind = c.LLVMGetTypeKind(val_ty);
if (val_kind == c.LLVMFloatTypeKind) {
const f = self.e.getOrDeclareMathF32(bi.builtin);
var args = [_]c.LLVMValueRef{val};
self.e.mapRef(c.LLVMBuildCall2(self.e.builder, self.e.getMathF32Type(), f, &args, 1, @tagName(bi.builtin)));
} else {
const coerced = if (val_kind != c.LLVMDoubleTypeKind) self.e.coerceArg(val, self.e.cached_f64) else val;
const f = self.e.getOrDeclareMathF64(bi.builtin);
var args = [_]c.LLVMValueRef{coerced};
self.e.mapRef(c.LLVMBuildCall2(self.e.builder, self.e.getMathF64Type(), f, &args, 1, @tagName(bi.builtin)));
}
},
.out => {
// out(str): extract ptr and len from string fat pointer, call write(1, ptr, len)
const str_val = self.e.resolveRef(bi.args[0]);
const raw_ptr = c.LLVMBuildExtractValue(self.e.builder, str_val, 0, "str.ptr");
const str_len = c.LLVMBuildExtractValue(self.e.builder, str_val, 1, "str.len");
// On wasm32, count param is i32 (size_t)
const count = if (self.e.target_config.isWasm32())
c.LLVMBuildTrunc(self.e.builder, str_len, self.e.cached_i32, "len.tr")
else
str_len;
const write_fn = self.e.getOrDeclareWrite();
var write_args = [_]c.LLVMValueRef{
c.LLVMConstInt(self.e.cached_i32, 1, 0), // fd = stdout
raw_ptr,
count,
};
_ = c.LLVMBuildCall2(self.e.builder, self.e.getWriteType(), write_fn, &write_args, 3, "");
self.e.advanceRefCounter();
},
.type_name => {
// Dynamic `type_name(t)` at runtime: resolve the TypeId
// the arg denotes (reading an `Any`'s runtime type-tag,
// not its payload — see `reflectArgTypeId`), GEP into the
// compiler-emitted `__sx_type_names` global, load the
// string.
const tid_idx = self.reflectArgTypeId(bi.args[0], "type_name");
const arr_global = self.e.reflection().getOrBuildTypeNameArray();
const arr_len = self.e.type_name_array_len;
const string_ty = self.e.getStringStructType();
const arr_ty = c.LLVMArrayType(string_ty, arr_len);
const zero = c.LLVMConstInt(self.e.cached_i64, 0, 0);
var indices = [2]c.LLVMValueRef{ zero, tid_idx };
const gep = c.LLVMBuildInBoundsGEP2(self.e.builder, arr_ty, arr_global, &indices, 2, "tn.gep");
const result = c.LLVMBuildLoad2(self.e.builder, string_ty, gep, "tn.load");
self.e.mapRef(result);
},
.type_eq => {
// Dynamic `type_eq(a, b)` — both args are
// Type values. Extract TypeId from each Any
// box (or use directly if `.i64`-typed),
// icmp eq.
const a = blk: {
const v = self.e.resolveRef(bi.args[0]);
break :blk switch (self.e.reflectArgRepr(bi.args[0])) {
.unresolved => @panic("type_eq: first reflection arg IR-type unresolved — a type-resolution failure reached LLVM emission without a diagnostic"),
.boxed => c.LLVMBuildExtractValue(self.e.builder, v, 1, "te.a"),
.bare => v,
};
};
const b = blk: {
const v = self.e.resolveRef(bi.args[1]);
break :blk switch (self.e.reflectArgRepr(bi.args[1])) {
.unresolved => @panic("type_eq: second reflection arg IR-type unresolved — a type-resolution failure reached LLVM emission without a diagnostic"),
.boxed => c.LLVMBuildExtractValue(self.e.builder, v, 1, "te.b"),
.bare => v,
};
};
const eq_res = c.LLVMBuildICmp(self.e.builder, c.LLVMIntEQ, a, b, "te.eq");
self.e.mapRef(eq_res);
},
.type_is_unsigned => {
// Dynamic `type_is_unsigned(t)`: resolve the TypeId the arg
// denotes (reading an `Any`'s runtime type-tag, not its
// payload — see `reflectArgTypeId`), GEP into the
// `__sx_type_is_unsigned` table, load the i1. Mirrors the
// `type_name` runtime lookup.
const tid_idx = self.reflectArgTypeId(bi.args[0], "type_is_unsigned");
const arr_global = self.e.reflection().getOrBuildTypeIsUnsignedArray();
const arr_len = self.e.type_is_unsigned_array_len;
const arr_ty = c.LLVMArrayType(self.e.cached_i1, arr_len);
const zero = c.LLVMConstInt(self.e.cached_i64, 0, 0);
var indices = [2]c.LLVMValueRef{ zero, tid_idx };
const gep = c.LLVMBuildInBoundsGEP2(self.e.builder, arr_ty, arr_global, &indices, 2, "tiu.gep");
const result = c.LLVMBuildLoad2(self.e.builder, self.e.cached_i1, gep, "tiu.load");
self.e.mapRef(result);
},
.has_impl => {
// Runtime has_impl needs a protocol-map
// snapshot — not wired yet. Silent false for
// now; the lower-time fold via
// `tryConstBoolCondition` covers every
// statically-resolvable call.
self.e.mapRef(c.LLVMConstInt(self.e.cached_i1, 0, 0));
},
else => {
// size_of, cast — handled by lowering or codegen glue
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
},
}
}
pub fn emitCompilerCall(self: Ops, instruction: *const Inst) void {
// Compiler hooks are comptime-only; if one reaches emission, produce undef
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
}
pub fn emitCallClosure(self: Ops, instruction: *const Inst, call_op: CallIndirect) void {
// Closure: { fn_ptr, env }.
//
// ABI (when module.has_implicit_ctx):
// trampoline signature: (__sx_ctx, env, args...)
// call_op.args[0] = __sx_ctx (prepended by lowering)
// call_op.args[1..] = user args
// extracted env_ptr = inserted at LLVM slot 1
//
// ABI (without implicit_ctx):
// trampoline signature: (env, args...)
// call_op.args = user args (no ctx prepend)
// extracted env_ptr = inserted at LLVM slot 0
const closure = self.e.resolveRef(call_op.callee);
const cl_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(closure));
if (cl_kind != c.LLVMStructTypeKind) {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
return;
}
const fn_ptr = c.LLVMBuildExtractValue(self.e.builder, closure, 0, "cl.fn");
const env_ptr = c.LLVMBuildExtractValue(self.e.builder, closure, 1, "cl.env");
// Get the closure's declared parameter types from the IR type system
const callee_ir_ty = self.e.getRefIRType(call_op.callee);
const closure_params: ?[]const TypeId = if (callee_ir_ty) |cty| blk: {
if (!cty.isBuiltin()) {
const ci = self.e.ir_mod.types.get(cty);
if (ci == .closure) break :blk ci.closure.params;
}
break :blk null;
} else null;
const has_ctx = self.e.ir_mod.has_implicit_ctx;
const user_args_offset_in_op: usize = if (has_ctx) 1 else 0;
const user_args_count: usize = call_op.args.len -| user_args_offset_in_op;
const ctx_slots: usize = if (has_ctx) 1 else 0;
const total_args = ctx_slots + 1 + user_args_count; // [ctx?] + env + user_args
const args = self.e.alloc.alloc(c.LLVMValueRef, total_args) catch unreachable;
defer self.e.alloc.free(args);
if (has_ctx) {
args[0] = self.e.resolveRef(call_op.args[0]); // ctx
}
args[ctx_slots] = env_ptr;
for (0..user_args_count) |j| {
args[ctx_slots + 1 + j] = self.e.resolveRef(call_op.args[user_args_offset_in_op + j]);
}
// Build function type using declared param types (not arg types).
// closure_params is user-visible (no ctx, no env), so they line
// up with args[ctx_slots+1..].
const ret_ty = self.e.toLLVMType(instruction.ty);
const param_tys = self.e.alloc.alloc(c.LLVMTypeRef, total_args) catch unreachable;
defer self.e.alloc.free(param_tys);
if (has_ctx) param_tys[0] = self.e.cached_ptr; // __sx_ctx
param_tys[ctx_slots] = self.e.cached_ptr; // env
if (closure_params) |cp| {
for (0..user_args_count) |j| {
const param_ir_ty = if (j < cp.len) cp[j] else null;
if (param_ir_ty) |pty| {
const llvm_pty = self.e.toLLVMType(pty);
param_tys[ctx_slots + 1 + j] = llvm_pty;
args[ctx_slots + 1 + j] = self.e.coerceArg(args[ctx_slots + 1 + j], llvm_pty);
} else {
param_tys[ctx_slots + 1 + j] = c.LLVMTypeOf(args[ctx_slots + 1 + j]);
}
}
} else {
for (0..user_args_count) |j| {
param_tys[ctx_slots + 1 + j] = c.LLVMTypeOf(args[ctx_slots + 1 + j]);
}
}
const fn_ty = c.LLVMFunctionType(ret_ty, param_tys.ptr, @intCast(total_args), 0);
const is_void = instruction.ty == .void;
const result = c.LLVMBuildCall2(self.e.builder, fn_ty, fn_ptr, args.ptr, @intCast(total_args), if (is_void) "" else "ccall");
if (!is_void) {
self.e.mapRef(result);
} else {
self.e.advanceRefCounter();
}
}
// ── Struct ops ────────────────────────────────────────────
pub fn emitStructInit(self: Ops, instruction: *const Inst, agg: Aggregate) void {
const struct_ty = self.e.toLLVMType(instruction.ty);
const type_kind = c.LLVMGetTypeKind(struct_ty);
// For vector types, use InsertElement instead of InsertValue
const is_vector = type_kind == c.LLVMVectorTypeKind or type_kind == c.LLVMScalableVectorTypeKind;
// For array types, get expected element type for coercion
const is_array = type_kind == c.LLVMArrayTypeKind;
const elem_llvm_ty = if (is_array) c.LLVMGetElementType(struct_ty) else null;
var result = c.LLVMGetUndef(struct_ty);
for (agg.fields, 0..) |field_ref, i| {
var field_val = self.e.resolveRef(field_ref);
if (is_vector) {
// Coerce element to match vector element type
const vec_elem_ty = c.LLVMGetElementType(struct_ty);
const val_ty = c.LLVMTypeOf(field_val);
if (val_ty != vec_elem_ty) {
field_val = self.e.coerceArg(field_val, vec_elem_ty);
}
const idx = c.LLVMConstInt(self.e.cached_i32, @intCast(i), 0);
result = c.LLVMBuildInsertElement(self.e.builder, result, field_val, idx, "vi");
} else {
// Coerce element to match array element type if needed
if (elem_llvm_ty) |elt| {
const val_ty = c.LLVMTypeOf(field_val);
if (val_ty != elt) {
const val_kind = c.LLVMGetTypeKind(val_ty);
const elt_kind = c.LLVMGetTypeKind(elt);
if (val_kind == c.LLVMIntegerTypeKind and elt_kind == c.LLVMIntegerTypeKind) {
const val_w = c.LLVMGetIntTypeWidth(val_ty);
const elt_w = c.LLVMGetIntTypeWidth(elt);
if (val_w > elt_w) {
field_val = c.LLVMBuildTrunc(self.e.builder, field_val, elt, "atrunc");
} else if (val_w < elt_w) {
field_val = c.LLVMBuildZExt(self.e.builder, field_val, elt, "aext");
}
}
}
} else if (type_kind == c.LLVMStructTypeKind) {
// Coerce struct field value to match declared field type
const n_elts = c.LLVMCountStructElementTypes(struct_ty);
if (n_elts > 0 and i < n_elts) {
const field_ty = c.LLVMStructGetTypeAtIndex(struct_ty, @intCast(i));
const val_ty = c.LLVMTypeOf(field_val);
if (val_ty != field_ty) {
field_val = self.e.coerceArg(field_val, field_ty);
}
}
}
result = c.LLVMBuildInsertValue(self.e.builder, result, field_val, @intCast(i), "si");
}
}
self.e.mapRef(result);
}
pub fn emitStructGet(self: Ops, instruction: *const Inst, fa: FieldAccess) void {
const base = self.e.resolveRef(fa.base);
// Safety: null base means unresolved reference — emit undef
if (base == null) {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
} else {
// Safety: check that base is an aggregate type (struct/array/vector), not scalar
const base_ty = c.LLVMTypeOf(base);
const base_ty_kind = c.LLVMGetTypeKind(base_ty);
if (base_ty_kind == c.LLVMVectorTypeKind or base_ty_kind == c.LLVMScalableVectorTypeKind) {
// Vector: use ExtractElement with an index
const idx = c.LLVMConstInt(self.e.cached_i32, @intCast(fa.field_index), 0);
const result = c.LLVMBuildExtractElement(self.e.builder, base, idx, "ve");
self.e.mapRef(result);
} else if (base_ty_kind == c.LLVMStructTypeKind or base_ty_kind == c.LLVMArrayTypeKind) {
// Validate field index is in bounds
const n_fields = if (base_ty_kind == c.LLVMStructTypeKind) c.LLVMCountStructElementTypes(base_ty) else 0;
// Check builder has valid insert point
const insert_bb = c.LLVMGetInsertBlock(self.e.builder);
if (insert_bb == null or (n_fields == 0 and base_ty_kind == c.LLVMStructTypeKind) or (n_fields > 0 and fa.field_index >= n_fields)) {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
} else {
const result = c.LLVMBuildExtractValue(self.e.builder, base, @intCast(fa.field_index), "sg");
self.e.mapRef(result);
}
} else {
// Base is not an aggregate (e.g., placeholder undef of scalar type)
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
}
}
}
pub fn emitStructGep(self: Ops, instruction: *const Inst, fa: FieldAccess) void {
const base_ptr = self.e.resolveRef(fa.base);
// Safety: verify base is a pointer before GEP
const base_ty_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(base_ptr));
if (base_ty_kind == c.LLVMPointerTypeKind) {
const struct_llvm_ty = if (fa.base_type) |bt|
self.e.toLLVMType(self.e.resolveAggregate(bt))
else
self.e.resolveGepStructType(fa.base, instruction);
const st_kind = c.LLVMGetTypeKind(struct_llvm_ty);
if (st_kind == c.LLVMVectorTypeKind or st_kind == c.LLVMScalableVectorTypeKind) {
// Vector lane address: GEP [0, lane] into the in-memory vector,
// yielding a pointer to the lane element for a scalar store
// (vector lane assignment). Mirrors how the read
// path extracts a lane; here we address it for a store.
var indices = [_]c.LLVMValueRef{
c.LLVMConstInt(self.e.cached_i64, 0, 0),
c.LLVMConstInt(self.e.cached_i64, @intCast(fa.field_index), 0),
};
const result = c.LLVMBuildGEP2(self.e.builder, struct_llvm_ty, base_ptr, &indices, 2, "vgep");
self.e.mapRef(result);
} else if (st_kind == c.LLVMStructTypeKind or st_kind == c.LLVMArrayTypeKind) {
const result = c.LLVMBuildStructGEP2(self.e.builder, struct_llvm_ty, base_ptr, @intCast(fa.field_index), "gep");
self.e.mapRef(result);
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_ptr));
}
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_ptr));
}
}
// ── Enum ops ─────────────────────────────────────────────
pub fn emitEnumInit(self: Ops, instruction: *const Inst, ei: EnumInit) void {
if (ei.payload.isNone()) {
// Simple enum (no payload) — just a tag integer
const ty = self.e.toLLVMType(instruction.ty);
const ty_kind = c.LLVMGetTypeKind(ty);
if (ty_kind == c.LLVMIntegerTypeKind) {
// Plain enum or builtin integer → integer constant
self.e.mapRef(c.LLVMConstInt(ty, ei.tag, 0));
} else if (ty_kind == c.LLVMStructTypeKind) {
// Tagged union with no payload — header field 0 holds the tag
const header_ty = c.LLVMStructGetTypeAtIndex(ty, 0);
const tag_val = c.LLVMConstInt(header_ty, ei.tag, 0);
var result = c.LLVMGetUndef(ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, tag_val, 0, "ei.tag");
self.e.mapRef(result);
} else {
self.e.mapRef(c.LLVMConstInt(self.e.cached_i64, ei.tag, 0));
}
} else {
// Tagged union with payload — { header, payload_bytes }
const union_ty = self.e.toLLVMType(instruction.ty);
const header_ty = c.LLVMStructGetTypeAtIndex(union_ty, 0);
const tag_val = c.LLVMConstInt(header_ty, ei.tag, 0);
const payload_val = self.e.resolveRef(ei.payload);
// alloca union, store tag, bitcast payload area, store payload
const tmp = self.e.buildEntryAlloca(union_ty, "ei.tmp");
// Store tag at field 0
const tag_ptr = c.LLVMBuildStructGEP2(self.e.builder, union_ty, tmp, 0, "ei.tagp");
_ = c.LLVMBuildStore(self.e.builder, tag_val, tag_ptr);
// Store payload at field 1 (bitcast the byte array to payload type)
const payload_ptr = c.LLVMBuildStructGEP2(self.e.builder, union_ty, tmp, 1, "ei.pp");
const payload_typed_ptr = c.LLVMBuildBitCast(self.e.builder, payload_ptr, self.e.cached_ptr, "ei.pcast");
_ = c.LLVMBuildStore(self.e.builder, payload_val, payload_typed_ptr);
// Load the whole union value
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, union_ty, tmp, "ei.val"));
}
}
pub fn emitEnumTag(self: Ops, instruction: *const Inst, un: UnaryOp) void {
const val = self.e.resolveRef(un.operand);
// Check if this is a plain enum (integer) or tagged union (struct with tag at 0)
const val_ty = c.LLVMTypeOf(val);
const kind = c.LLVMGetTypeKind(val_ty);
if (kind == c.LLVMStructTypeKind) {
// Tagged union — extract field 0 (tag)
var tag = c.LLVMBuildExtractValue(self.e.builder, val, 0, "etag");
// Truncate to declared tag width if needed (e.g. i64 → i32 for u32 tags)
// This is essential for FFI unions where the i64 tag slot contains
// a smaller tag + uninitialized padding (e.g. SDL_Event's u32 type + u32 reserved)
const target_ty = self.e.toLLVMType(instruction.ty);
const extracted_bits = c.LLVMGetIntTypeWidth(c.LLVMTypeOf(tag));
const target_bits = c.LLVMGetIntTypeWidth(target_ty);
if (target_bits < extracted_bits) {
tag = c.LLVMBuildTrunc(self.e.builder, tag, target_ty, "etag.trunc");
}
self.e.mapRef(tag);
} else {
// Plain enum — the value IS the tag
self.e.mapRef(val);
}
}
pub fn emitEnumPayload(self: Ops, instruction: *const Inst, fa: FieldAccess) void {
const base = self.e.resolveRef(fa.base);
const result_ty = self.e.toLLVMType(instruction.ty);
const base_ty = c.LLVMTypeOf(base);
const base_kind = c.LLVMGetTypeKind(base_ty);
if (base_kind == c.LLVMStructTypeKind) {
// Tagged union: alloca, store, GEP field 1 (payload area), bitcast, load
const tmp = self.e.buildEntryAlloca(base_ty, "ep.tmp");
_ = c.LLVMBuildStore(self.e.builder, base, tmp);
const payload_ptr = c.LLVMBuildStructGEP2(self.e.builder, base_ty, tmp, 1, "ep.pp");
const typed_ptr = c.LLVMBuildBitCast(self.e.builder, payload_ptr, self.e.cached_ptr, "ep.cast");
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, result_ty, typed_ptr, "ep.val"));
} else {
self.e.mapRef(c.LLVMGetUndef(result_ty));
}
}
// ── Union ops ────────────────────────────────────────────
pub fn emitUnionGet(self: Ops, instruction: *const Inst, fa: FieldAccess) void {
const base = self.e.resolveRef(fa.base);
const result_ty = self.e.toLLVMType(instruction.ty);
// Union field access: reinterpret the union's data area as the target type
const base_ty = c.LLVMTypeOf(base);
const kind = c.LLVMGetTypeKind(base_ty);
if (kind == c.LLVMStructTypeKind) {
// Tagged union { header, payload_bytes } — access payload at field 1
const tmp = self.e.buildEntryAlloca(base_ty, "ug.tmp");
_ = c.LLVMBuildStore(self.e.builder, base, tmp);
const payload_ptr = c.LLVMBuildStructGEP2(self.e.builder, base_ty, tmp, 1, "ug.pp");
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, result_ty, payload_ptr, "ug.val"));
} else {
// Untagged union [N x i8] — alloca, store, reinterpret-load
const tmp = self.e.buildEntryAlloca(base_ty, "ug.tmp");
_ = c.LLVMBuildStore(self.e.builder, base, tmp);
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, result_ty, tmp, "ug.val"));
}
}
pub fn emitUnionGep(self: Ops, instruction: *const Inst, fa: FieldAccess) void {
const base_ptr = self.e.resolveRef(fa.base);
const base_ty_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(base_ptr));
if (base_ty_kind == c.LLVMPointerTypeKind) {
const union_llvm_ty = if (fa.base_type) |bt|
self.e.toLLVMType(self.e.resolveAggregate(bt))
else
self.e.resolveGepStructType(fa.base, instruction);
const st_kind = c.LLVMGetTypeKind(union_llvm_ty);
if (st_kind == c.LLVMStructTypeKind) {
// Tagged union — payload is at field 1
const payload_ptr = c.LLVMBuildStructGEP2(self.e.builder, union_llvm_ty, base_ptr, 1, "ugep.pp");
self.e.mapRef(payload_ptr);
} else {
// Untagged union — data starts at offset 0
self.e.mapRef(base_ptr);
}
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_ptr));
}
}
// ── Array/Slice ops ───────────────────────────────────────
pub fn emitIndexGet(self: Ops, instruction: *const Inst, bin: BinOp) void {
const base = self.e.resolveRef(bin.lhs);
const idx = self.e.resolveRef(bin.rhs);
const base_ty = c.LLVMTypeOf(base);
const kind = c.LLVMGetTypeKind(base_ty);
if (kind == c.LLVMVectorTypeKind or kind == c.LLVMScalableVectorTypeKind) {
// Vector — use extractelement
// Coerce index to i32 if needed
const idx32 = self.e.coerceArg(idx, self.e.cached_i32);
self.e.mapRef(c.LLVMBuildExtractElement(self.e.builder, base, idx32, "ve"));
} else if (kind == c.LLVMArrayTypeKind) {
// Fixed-size array value — alloca, store, GEP, load
const tmp = self.e.buildEntryAlloca(base_ty, "ig.tmp");
_ = c.LLVMBuildStore(self.e.builder, base, tmp);
const elem_ty = self.e.toLLVMType(instruction.ty);
var indices = [_]c.LLVMValueRef{ c.LLVMConstInt(self.e.cached_i64, 0, 0), idx };
const ptr = c.LLVMBuildGEP2(self.e.builder, base_ty, tmp, &indices, 2, "ig.ptr");
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, elem_ty, ptr, "ig.val"));
} else if (kind == c.LLVMPointerTypeKind) {
// Pointer (many-pointer or raw ptr) — GEP + load
const elem_ty = self.e.toLLVMType(instruction.ty);
var indices = [_]c.LLVMValueRef{idx};
const ptr = c.LLVMBuildGEP2(self.e.builder, elem_ty, base, &indices, 1, "ig.ptr");
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, elem_ty, ptr, "ig.val"));
} else if (kind == c.LLVMStructTypeKind) {
// Slice/string {ptr, len} — extract ptr, GEP, load
const data = c.LLVMBuildExtractValue(self.e.builder, base, 0, "ig.data");
const elem_ty = self.e.toLLVMType(instruction.ty);
var indices = [_]c.LLVMValueRef{idx};
const ptr = c.LLVMBuildGEP2(self.e.builder, elem_ty, data, &indices, 1, "ig.ptr");
self.e.mapRef(c.LLVMBuildLoad2(self.e.builder, elem_ty, ptr, "ig.val"));
} else {
// Non-aggregate base (lowering error) — emit undef
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
}
}
pub fn emitIndexGep(self: Ops, instruction: *const Inst, bin: BinOp) void {
const base = self.e.resolveRef(bin.lhs);
const idx = self.e.resolveRef(bin.rhs);
const base_ty = c.LLVMTypeOf(base);
const kind = c.LLVMGetTypeKind(base_ty);
if (kind == c.LLVMArrayTypeKind) {
// Fixed-size array value — alloca, store, GEP
const tmp = self.e.buildEntryAlloca(base_ty, "igp.tmp");
_ = c.LLVMBuildStore(self.e.builder, base, tmp);
var indices = [_]c.LLVMValueRef{ c.LLVMConstInt(self.e.cached_i64, 0, 0), idx };
self.e.mapRef(c.LLVMBuildGEP2(self.e.builder, base_ty, tmp, &indices, 2, "igp.ptr"));
} else if (kind == c.LLVMPointerTypeKind) {
// Pointer — GEP with proper element type
const gep_elem = blk: {
// instruction.ty is the result type (ptr to element)
// Resolve the pointee type for the GEP element size
const info = self.e.ir_mod.types.get(instruction.ty);
break :blk switch (info) {
.pointer => |p| self.e.toLLVMType(p.pointee),
.many_pointer => |p| self.e.toLLVMType(p.element),
else => self.e.cached_i8, // fallback
};
};
var indices = [_]c.LLVMValueRef{idx};
self.e.mapRef(c.LLVMBuildGEP2(self.e.builder, gep_elem, base, &indices, 1, "igp.ptr"));
} else if (kind == c.LLVMStructTypeKind) {
// Slice/string {ptr, len} — extract ptr, GEP with proper element type
const data = c.LLVMBuildExtractValue(self.e.builder, base, 0, "igp.data");
const gep_elem = blk: {
const info = self.e.ir_mod.types.get(instruction.ty);
break :blk switch (info) {
.pointer => |p| self.e.toLLVMType(p.pointee),
.many_pointer => |p| self.e.toLLVMType(p.element),
else => self.e.cached_i8,
};
};
var indices = [_]c.LLVMValueRef{idx};
self.e.mapRef(c.LLVMBuildGEP2(self.e.builder, gep_elem, data, &indices, 1, "igp.ptr"));
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_ptr));
}
}
pub fn emitLength(self: Ops, un: UnaryOp) void {
const val = self.e.resolveRef(un.operand);
const val_ty = c.LLVMTypeOf(val);
const kind = c.LLVMGetTypeKind(val_ty);
if (kind == c.LLVMArrayTypeKind) {
const len = c.LLVMGetArrayLength2(val_ty);
self.e.mapRef(c.LLVMConstInt(self.e.cached_i64, len, 0));
} else if (kind == c.LLVMStructTypeKind) {
// Slice/string {ptr, len} — extract field 1 (len)
self.e.mapRef(c.LLVMBuildExtractValue(self.e.builder, val, 1, "len"));
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_i64));
}
}
pub fn emitDataPtr(self: Ops, un: UnaryOp) void {
const val = self.e.resolveRef(un.operand);
const val_ty = c.LLVMTypeOf(val);
const kind = c.LLVMGetTypeKind(val_ty);
if (kind == c.LLVMStructTypeKind) {
self.e.mapRef(c.LLVMBuildExtractValue(self.e.builder, val, 0, "dptr"));
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.cached_ptr));
}
}
pub fn emitSubslice(self: Ops, instruction: *const Inst, ss: Subslice) void {
const base = self.e.resolveRef(ss.base);
var lo = self.e.resolveRef(ss.lo);
var hi = self.e.resolveRef(ss.hi);
// Normalize lo/hi to i64 for consistent arithmetic (indices are unsigned)
if (c.LLVMTypeOf(lo) != self.e.cached_i64) {
lo = c.LLVMBuildZExt(self.e.builder, lo, self.e.cached_i64, "ss.lo64");
}
if (c.LLVMTypeOf(hi) != self.e.cached_i64) {
hi = c.LLVMBuildZExt(self.e.builder, hi, self.e.cached_i64, "ss.hi64");
}
const base_ty = c.LLVMTypeOf(base);
const base_kind = c.LLVMGetTypeKind(base_ty);
const slice_ty = self.e.toLLVMType(instruction.ty);
// Resolve element type from the result slice type for correct GEP stride
const elem_ty = blk: {
const info = self.e.ir_mod.types.get(instruction.ty);
break :blk switch (info) {
.slice => |s| self.e.toLLVMType(s.element),
else => self.e.cached_i8,
};
};
if (base_kind == c.LLVMStructTypeKind) {
// Slice/string: extract data ptr, GEP by lo
const data = c.LLVMBuildExtractValue(self.e.builder, base, 0, "ss.data");
var lo_indices = [_]c.LLVMValueRef{lo};
const new_ptr = c.LLVMBuildGEP2(self.e.builder, elem_ty, data, &lo_indices, 1, "ss.ptr");
var new_len = c.LLVMBuildSub(self.e.builder, hi, lo, "ss.len");
// Ensure length is i64 for slice struct {ptr, i64}
if (c.LLVMTypeOf(new_len) != self.e.cached_i64) {
new_len = c.LLVMBuildSExt(self.e.builder, new_len, self.e.cached_i64, "ss.ext");
}
var result = c.LLVMGetUndef(slice_ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, new_ptr, 0, "ss.wptr");
result = c.LLVMBuildInsertValue(self.e.builder, result, new_len, 1, "ss.wlen");
self.e.mapRef(result);
} else if (base_kind == c.LLVMArrayTypeKind) {
// Array: alloca, GEP to element at lo, compute len
const tmp = self.e.buildEntryAlloca(base_ty, "ss.arr");
_ = c.LLVMBuildStore(self.e.builder, base, tmp);
var indices = [_]c.LLVMValueRef{ c.LLVMConstInt(self.e.cached_i64, 0, 0), lo };
const new_ptr = c.LLVMBuildGEP2(self.e.builder, base_ty, tmp, &indices, 2, "ss.ptr");
var new_len = c.LLVMBuildSub(self.e.builder, hi, lo, "ss.len");
// Ensure length is i64 for slice struct {ptr, i64}
if (c.LLVMTypeOf(new_len) != self.e.cached_i64) {
new_len = c.LLVMBuildSExt(self.e.builder, new_len, self.e.cached_i64, "ss.ext");
}
var result = c.LLVMGetUndef(slice_ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, new_ptr, 0, "ss.wptr");
result = c.LLVMBuildInsertValue(self.e.builder, result, new_len, 1, "ss.wlen");
self.e.mapRef(result);
} else {
self.e.mapRef(c.LLVMGetUndef(slice_ty));
}
}
pub fn emitArrayToSlice(self: Ops, instruction: *const Inst, un: UnaryOp) void {
const arr = self.e.resolveRef(un.operand);
const arr_ty = c.LLVMTypeOf(arr);
const arr_kind = c.LLVMGetTypeKind(arr_ty);
if (arr_kind == c.LLVMArrayTypeKind) {
const len = c.LLVMGetArrayLength2(arr_ty);
const tmp = self.e.buildEntryAlloca(arr_ty, "a2s.tmp");
_ = c.LLVMBuildStore(self.e.builder, arr, tmp);
var indices = [_]c.LLVMValueRef{ c.LLVMConstInt(self.e.cached_i64, 0, 0), c.LLVMConstInt(self.e.cached_i64, 0, 0) };
const elem_ptr = c.LLVMBuildGEP2(self.e.builder, arr_ty, tmp, &indices, 2, "a2s.ptr");
const slice_ty = self.e.toLLVMType(instruction.ty);
var result = c.LLVMGetUndef(slice_ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, elem_ptr, 0, "a2s.wptr");
const len_val = c.LLVMConstInt(self.e.cached_i64, len, 0);
result = c.LLVMBuildInsertValue(self.e.builder, result, len_val, 1, "a2s.wlen");
self.e.mapRef(result);
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
}
}
// ── Tuple ops ────────────────────────────────────────────
pub fn emitTupleInit(self: Ops, instruction: *const Inst, agg: Aggregate) void {
const tuple_ty = self.e.toLLVMType(instruction.ty);
var result = c.LLVMGetUndef(tuple_ty);
for (agg.fields, 0..) |field_ref, i| {
const field_val = self.e.resolveRef(field_ref);
result = c.LLVMBuildInsertValue(self.e.builder, result, field_val, @intCast(i), "ti");
}
self.e.mapRef(result);
}
pub fn emitTupleGet(self: Ops, fa: FieldAccess) void {
const base = self.e.resolveRef(fa.base);
self.e.mapRef(c.LLVMBuildExtractValue(self.e.builder, base, @intCast(fa.field_index), "tg"));
}
// ── Optional ops ─────────────────────────────────────────
pub fn emitOptionalWrap(self: Ops, instruction: *const Inst, un: UnaryOp) void {
var val = self.e.resolveRef(un.operand);
const opt_ty = self.e.toLLVMType(instruction.ty);
const opt_kind = c.LLVMGetTypeKind(opt_ty);
if (opt_kind == c.LLVMPointerTypeKind) {
// ?*T — pointer is the optional itself (null = none)
self.e.mapRef(val);
} else if (opt_kind == c.LLVMStructTypeKind) {
// Distinguish {T, i1} (real optional) from {ptr, ptr} (?Closure)
const num_fields = c.LLVMCountStructElementTypes(opt_ty);
const last_field_ty = if (num_fields > 0) c.LLVMStructGetTypeAtIndex(opt_ty, num_fields - 1) else self.e.cached_i1;
if (last_field_ty == self.e.cached_i1) {
// ?T → { T, i1 } — wrap value + true flag
const inner_ty = c.LLVMStructGetTypeAtIndex(opt_ty, 0);
val = self.e.coerceArg(val, inner_ty);
var result = c.LLVMGetUndef(opt_ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, val, 0, "ow.val");
result = c.LLVMBuildInsertValue(self.e.builder, result, c.LLVMConstInt(self.e.cached_i1, 1, 0), 1, "ow.has");
self.e.mapRef(result);
} else {
// ?Closure → closure struct IS the optional, just pass through
self.e.mapRef(val);
}
} else {
self.e.mapRef(val);
}
}
pub fn emitOptionalUnwrap(self: Ops, un: UnaryOp) void {
const val = self.e.resolveRef(un.operand);
const val_ty = c.LLVMTypeOf(val);
const kind = c.LLVMGetTypeKind(val_ty);
if (kind == c.LLVMStructTypeKind) {
// Distinguish {T, i1} (real optional) from {ptr, ptr} (?Closure)
const num_fields = c.LLVMCountStructElementTypes(val_ty);
const last_field_ty = if (num_fields > 0) c.LLVMStructGetTypeAtIndex(val_ty, num_fields - 1) else self.e.cached_i1;
if (last_field_ty == self.e.cached_i1) {
// { T, i1 } → extract field 0
self.e.mapRef(c.LLVMBuildExtractValue(self.e.builder, val, 0, "ou.val"));
} else {
// ?Closure → the struct itself is the value
self.e.mapRef(val);
}
} else {
// ?*T → pointer is the value itself
self.e.mapRef(val);
}
}
pub fn emitOptionalHasValue(self: Ops, un: UnaryOp) void {
const val = self.e.resolveRef(un.operand);
const val_ty = c.LLVMTypeOf(val);
const kind = c.LLVMGetTypeKind(val_ty);
if (kind == c.LLVMStructTypeKind) {
// Distinguish {T, i1} (real optional) from {ptr, ptr} (?Closure)
const num_fields = c.LLVMCountStructElementTypes(val_ty);
const last_field_ty = if (num_fields > 0) c.LLVMStructGetTypeAtIndex(val_ty, num_fields - 1) else self.e.cached_i1;
if (last_field_ty == self.e.cached_i1) {
// { T, i1 } → extract has_value flag
self.e.mapRef(c.LLVMBuildExtractValue(self.e.builder, val, num_fields - 1, "oh.has"));
} else {
// ?Closure {fn_ptr, env} → check if fn_ptr is null
const fn_ptr = c.LLVMBuildExtractValue(self.e.builder, val, 0, "oh.fn");
self.e.mapRef(c.LLVMBuildICmp(self.e.builder, c.LLVMIntNE, fn_ptr, c.LLVMConstNull(c.LLVMTypeOf(fn_ptr)), "oh.nn"));
}
} else {
// ?*T → compare with null
const is_nonnull = c.LLVMBuildICmp(self.e.builder, c.LLVMIntNE, val, c.LLVMConstNull(val_ty), "oh.nn");
self.e.mapRef(is_nonnull);
}
}
pub fn emitOptionalCoalesce(self: Ops, bin: BinOp) void {
// a ?? b — if a has value, use a's value; otherwise use b
const a = self.e.resolveRef(bin.lhs);
var b_val = self.e.resolveRef(bin.rhs);
const a_ty = c.LLVMTypeOf(a);
const kind = c.LLVMGetTypeKind(a_ty);
if (kind == c.LLVMStructTypeKind) {
const n_fields = c.LLVMCountStructElementTypes(a_ty);
const f1_ty = if (n_fields >= 2) c.LLVMStructGetTypeAtIndex(a_ty, 1) else null;
const is_ti1 = if (f1_ty) |ft| c.LLVMGetTypeKind(ft) == c.LLVMIntegerTypeKind and c.LLVMGetIntTypeWidth(ft) == 1 else false;
if (is_ti1) {
// Standard optional {T, i1}: extract has_value and unwrap
const has = c.LLVMBuildExtractValue(self.e.builder, a, 1, "oc.has");
const unwrapped = c.LLVMBuildExtractValue(self.e.builder, a, 0, "oc.val");
const uw_ty = c.LLVMTypeOf(unwrapped);
const b_ty = c.LLVMTypeOf(b_val);
if (uw_ty != b_ty) {
b_val = self.e.coerceArg(b_val, uw_ty);
}
self.e.mapRef(c.LLVMBuildSelect(self.e.builder, has, unwrapped, b_val, "oc.sel"));
} else {
// ?Closure {fn_ptr, env}: check if fn_ptr is null
const fn_ptr = c.LLVMBuildExtractValue(self.e.builder, a, 0, "oc.fn");
const is_nonnull = c.LLVMBuildICmp(self.e.builder, c.LLVMIntNE, fn_ptr, c.LLVMConstNull(c.LLVMTypeOf(fn_ptr)), "oc.nn");
// Select the full closure struct, not just the fn_ptr
self.e.mapRef(c.LLVMBuildSelect(self.e.builder, is_nonnull, a, b_val, "oc.sel"));
}
} else {
// ?*T — select on null
const is_nonnull = c.LLVMBuildICmp(self.e.builder, c.LLVMIntNE, a, c.LLVMConstNull(a_ty), "oc.nn");
self.e.mapRef(c.LLVMBuildSelect(self.e.builder, is_nonnull, a, b_val, "oc.sel"));
}
}
// ── Terminators ────────────────────────────────────────
pub fn emitRet(self: Ops, un: UnaryOp) void {
var val = self.e.resolveRef(un.operand);
const func = &self.e.ir_mod.functions.items[self.e.current_func_idx];
// Failable main: wrap the return in the entry-point reporter
// (ERR E4.2) — exit 0 (or the value) on success, else print the
// trace + tag to stderr and exit 1 — instead of returning the
// tag/tuple as the raw exit code. Two shapes:
// `-> !` → `val` is the bare u32 error tag.
// `-> (int, !)` → `val` is a `{value, tag}` tuple; extract both.
if (self.e.current_func_is_main) {
const rinfo = self.e.ir_mod.types.get(func.ret);
if (rinfo == .error_set) {
self.e.emitFailableMainRet(null, val);
self.e.advanceRefCounter();
return;
}
if (rinfo == .tuple and rinfo.tuple.fields.len == 2 and
self.e.ir_mod.types.get(rinfo.tuple.fields[1]) == .error_set)
{
const value = c.LLVMBuildExtractValue(self.e.builder, val, 0, "main.ret.val");
const tag = c.LLVMBuildExtractValue(self.e.builder, val, 1, "main.ret.tag");
self.e.emitFailableMainRet(value, tag);
self.e.advanceRefCounter();
return;
}
}
// sret-shaped function: declared return-type-in-IR is
// the struct, but the LLVM signature is void with a
// prepended ptr sret param. Store the value through
// the sret slot and emit ret void.
const needs_c_abi = func.is_extern or func.call_conv == .c;
const raw_ret = self.e.toLLVMType(func.ret);
if (needs_c_abi and self.e.needsByval(func.ret, raw_ret)) {
const llvm_func2 = c.LLVMGetBasicBlockParent(c.LLVMGetInsertBlock(self.e.builder));
const sret_ptr = c.LLVMGetParam(llvm_func2, 0);
_ = c.LLVMBuildStore(self.e.builder, val, sret_ptr);
_ = c.LLVMBuildRetVoid(self.e.builder);
self.e.advanceRefCounter();
return;
}
// Coerce return value to match the function's LLVM return type
const llvm_func = c.LLVMGetBasicBlockParent(c.LLVMGetInsertBlock(self.e.builder));
const fn_ty = c.LLVMGlobalGetValueType(llvm_func);
const expected_ret = c.LLVMGetReturnType(fn_ty);
val = self.e.coerceArg(val, expected_ret);
// If coercion didn't fix the type (e.g. dead comptime function),
// emit undef of the correct type to avoid LLVM verification error
if (c.LLVMTypeOf(val) != expected_ret) {
val = c.LLVMGetUndef(expected_ret);
}
_ = c.LLVMBuildRet(self.e.builder, val);
self.e.advanceRefCounter();
}
pub fn emitRetVoid(self: Ops) void {
if (self.e.current_func_is_main) {
// main must return i32 0 for JIT
_ = c.LLVMBuildRet(self.e.builder, c.LLVMConstInt(self.e.cached_i32, 0, 0));
} else {
_ = c.LLVMBuildRetVoid(self.e.builder);
}
self.e.advanceRefCounter();
}
pub fn emitUnreachable(self: Ops) void {
_ = c.LLVMBuildUnreachable(self.e.builder);
self.e.advanceRefCounter();
}
pub fn emitBr(self: Ops, branch: Branch, func_idx: u32) void {
const target = self.e.getBlock(func_idx, branch.target);
_ = c.LLVMBuildBr(self.e.builder, target);
self.e.advanceRefCounter();
}
pub fn emitCondBr(self: Ops, cbr: CondBranch, func_idx: u32) void {
var cond = self.e.resolveRef(cbr.cond);
const then_bb = self.e.getBlock(func_idx, cbr.then_target);
const else_bb = self.e.getBlock(func_idx, cbr.else_target);
// Coerce condition to i1 if needed (e.g., loaded bool stored as i64)
const cond_ty = c.LLVMTypeOf(cond);
const cond_kind = c.LLVMGetTypeKind(cond_ty);
if (cond_ty != self.e.cached_i1) {
if (cond_kind == c.LLVMPointerTypeKind) {
cond = c.LLVMBuildICmp(self.e.builder, c.LLVMIntNE, cond, c.LLVMConstNull(cond_ty), "tobool");
} else if (cond_kind == c.LLVMIntegerTypeKind) {
cond = c.LLVMBuildICmp(self.e.builder, c.LLVMIntNE, cond, c.LLVMConstInt(cond_ty, 0, 0), "tobool");
} else if (cond_kind == c.LLVMStructTypeKind) {
// Struct values are always truthy
cond = c.LLVMConstInt(self.e.cached_i1, 1, 0);
} else {
cond = c.LLVMConstInt(self.e.cached_i1, 1, 0); // default truthy
}
}
_ = c.LLVMBuildCondBr(self.e.builder, cond, then_bb, else_bb);
self.e.advanceRefCounter();
}
// ── Box/Unbox Any ──────────────────────────────────────
pub fn emitBoxAny(self: Ops, ba: BoxAny) void {
const val = self.e.resolveRef(ba.operand);
const any_ty = self.e.getAnyStructType();
// Any = { type_tag: i64, value: i64 }
const tag = c.LLVMConstInt(self.e.cached_i64, self.e.anyTag(ba.source_type), 0);
// Bitcast value to i64, using SExt for signed types, ZExt otherwise
const is_signed = self.e.isSignedTypeEx(ba.source_type);
const val_as_i64 = if (is_signed) self.e.coerceToI64Signed(val) else self.e.coerceToI64(val);
var result = c.LLVMGetUndef(any_ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, tag, 0, "ba.tag");
result = c.LLVMBuildInsertValue(self.e.builder, result, val_as_i64, 1, "ba.val");
self.e.mapRef(result);
}
pub fn emitUnboxAny(self: Ops, instruction: *const Inst, un: UnaryOp) void {
const any_val = self.e.resolveRef(un.operand);
const any_kind = c.LLVMGetTypeKind(c.LLVMTypeOf(any_val));
if (any_kind == c.LLVMStructTypeKind) {
const raw = c.LLVMBuildExtractValue(self.e.builder, any_val, 1, "ua.raw");
const target_ty = self.e.toLLVMType(instruction.ty);
self.e.mapRef(self.e.coerceFromI64(raw, target_ty));
} else {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
}
}
// ── Reflection ops ─────────────────────────────────────
pub fn emitFieldNameGet(self: Ops, fr: FieldReflect) void {
// Build global string array for this struct's field names, then GEP at runtime index
const global = self.e.reflection().getOrBuildFieldNameArray(fr.struct_type);
const idx = self.e.resolveRef(fr.index);
const string_ty = self.e.getStringStructType();
// Get struct field count for array type
const field_info = self.e.ir_mod.types.get(fr.struct_type);
const field_count: u32 = switch (field_info) {
.@"struct" => |s| @intCast(s.fields.len),
.@"union" => |u| @intCast(u.fields.len),
.tagged_union => |u| @intCast(u.fields.len),
.@"enum" => |e| @intCast(e.variants.len),
else => 0,
};
const array_ty = c.LLVMArrayType(string_ty, field_count);
const zero = c.LLVMConstInt(self.e.cached_i64, 0, 0);
var indices = [2]c.LLVMValueRef{ zero, idx };
const gep = c.LLVMBuildInBoundsGEP2(self.e.builder, array_ty, global, &indices, 2, "fn.gep");
const result = c.LLVMBuildLoad2(self.e.builder, string_ty, gep, "fn.load");
self.e.mapRef(result);
}
pub fn emitFieldValueGet(self: Ops, fr: FieldReflect, func_idx: u32) void {
// Switch on index, each case: extractvalue field k → box as Any
self.e.emitFieldValueGet(fr, func_idx);
}
pub fn emitErrorTagNameGet(self: Ops, u: UnaryOp) void {
// Tag id → name: GEP into the always-linked tag-name table at
// the runtime tag id (the error-set value, a u32). Out-of-range
// ids can't occur — ids come from the same registry the table
// is built from — so no bounds branch is needed.
const global = self.e.reflection().getOrBuildTagNameArray();
const tag_raw = self.e.resolveRef(u.operand);
const idx = c.LLVMBuildZExt(self.e.builder, tag_raw, self.e.cached_i64, "etn.idx");
const string_ty = self.e.getStringStructType();
const n: u32 = @intCast(self.e.ir_mod.types.tags.names.items.len);
const array_ty = c.LLVMArrayType(string_ty, n);
const zero = c.LLVMConstInt(self.e.cached_i64, 0, 0);
var indices = [2]c.LLVMValueRef{ zero, idx };
const gep = c.LLVMBuildInBoundsGEP2(self.e.builder, array_ty, global, &indices, 2, "etn.gep");
const result = c.LLVMBuildLoad2(self.e.builder, string_ty, gep, "etn.load");
self.e.mapRef(result);
}
// ── Switch branch ──────────────────────────────────────
pub fn emitSwitchBr(self: Ops, sw: SwitchBranch, func_idx: u32) void {
const operand = self.e.resolveRef(sw.operand);
const default_bb = self.e.getBlock(func_idx, sw.default);
const switch_inst = c.LLVMBuildSwitch(self.e.builder, operand, default_bb, @intCast(sw.cases.len));
for (sw.cases) |case| {
const case_val = c.LLVMConstInt(c.LLVMTypeOf(operand), @bitCast(case.value), 0);
const case_bb = self.e.getBlock(func_idx, case.target);
c.LLVMAddCase(switch_inst, case_val, case_bb);
}
self.e.advanceRefCounter();
}
// ── Closure creation ───────────────────────────────────
pub fn emitClosureCreate(self: Ops, cc: ClosureCreate) void {
const fn_val = self.e.func_map.get(cc.func.index()) orelse c.LLVMGetUndef(self.e.cached_ptr);
const env_val = if (cc.env.isNone()) c.LLVMConstNull(self.e.cached_ptr) else self.e.resolveRef(cc.env);
const closure_ty = self.e.getClosureStructType();
var result = c.LLVMGetUndef(closure_ty);
result = c.LLVMBuildInsertValue(self.e.builder, result, fn_val, 0, "cc.fn");
result = c.LLVMBuildInsertValue(self.e.builder, result, env_val, 1, "cc.env");
self.e.mapRef(result);
}
// ── Vector ops ─────────────────────────────────────────
pub fn emitVecSplat(self: Ops, instruction: *const Inst, un: UnaryOp) void {
const scalar = self.e.resolveRef(un.operand);
const vec_ty = self.e.toLLVMType(instruction.ty);
const vec_len = c.LLVMGetVectorSize(vec_ty);
// Build a splat: insertelement into undef for each lane
var result = c.LLVMGetUndef(vec_ty);
var i: c_uint = 0;
while (i < vec_len) : (i += 1) {
const idx_val = c.LLVMConstInt(self.e.cached_i32, i, 0);
result = c.LLVMBuildInsertElement(self.e.builder, result, scalar, idx_val, "splat");
}
self.e.mapRef(result);
}
pub fn emitVecExtract(self: Ops, bin: BinOp) void {
const vec = self.e.resolveRef(bin.lhs);
const idx = self.e.resolveRef(bin.rhs);
self.e.mapRef(c.LLVMBuildExtractElement(self.e.builder, vec, idx, "vext"));
}
pub fn emitVecInsert(self: Ops, tri: TriOp) void {
const vec = self.e.resolveRef(tri.a);
const idx = self.e.resolveRef(tri.b);
const val = self.e.resolveRef(tri.c);
self.e.mapRef(c.LLVMBuildInsertElement(self.e.builder, vec, val, idx, "vins"));
}
// ── Block params ───────────────────────────────────────
pub fn emitBlockParam(self: Ops, instruction: *const Inst, bp: BlockParam) void {
// Create a PHI node — incoming values are filled in by fixupPhiNodes
const ty = self.e.toLLVMType(instruction.ty);
const phi = c.LLVMBuildPhi(self.e.builder, ty, "bp");
self.e.pending_phis.append(self.e.alloc, .{
.phi = phi,
.block_id = bp.block,
.param_index = bp.param_index,
}) catch unreachable;
self.e.mapRef(phi);
}
// ── Misc ───────────────────────────────────────────────
pub fn emitPlaceholder(self: Ops, instruction: *const Inst) void {
self.e.mapRef(c.LLVMGetUndef(self.e.toLLVMType(instruction.ty)));
}
};