cd5b958d19
Introduce the welded comptime `compiler` library (`#library "compiler"` +
`abi(.zig) extern compiler`), per design/comptime-compiler-api.md, and unify
`callconv(...)` into the new `abi(...)` annotation.
abi(...) replaces callconv(...):
- New ABI enum { default, c, zig, pure }; `abi(.c|.zig|.pure)` parses in the
postfix slot before extern/export (and standalone). `kw_callconv` -> `kw_abi`.
- Migrated 52 sx files, the call-convention-mismatch diagnostic, and docs
(readme/specs) from `callconv(.c)` to `abi(.c)`.
Phase 1 — welded compiler library (parse -> registry -> validation -> bridge):
- `abi(.zig) extern compiler` parses on fn decls (carries abi/extern_lib) and
struct decls (StructDecl.abi/extern_lib).
- `#library "compiler"` is the comptime-only internal surface — never dlopen'd.
- src/ir/compiler_lib.zig: the binding registry (the safety boundary). `Field`
welded to StructInfo.Field with layout baked from the real Zig type
(@offsetOf/@sizeOf); `findType`/`findFn`. Welded structs are layout-validated
at registration (field set + total size) as a header checked against the impl.
- Host-call bridge: a `fn abi(.zig) extern compiler` dispatches under the
comptime interp to its registered Zig handler (intern/text_of round-trip),
never dlsym. IR Function.compiler_welded; validated in declareFunction.
- Comptime-only enforcement: a runtime call to a welded fn is a clean
build-gating error (emitCall), not an undefined-symbol link failure.
Phase 2.1 — byte-layout weld foundation:
- Decision: full byte-layout weld (sx struct laid out byte-identically to the
bound Zig type). Registered StructInfo (first non-natural / Zig-reordered
layout). `computeWeldPlan` — pure offset-ordered element plan + padding +
sx-field->LLVM-element remap; unit-tested. Emit/interp wiring is the next
sub-step (2.2+, see current/CHECKPOINT-COMPILER-API.md).
Examples: 0625/0626 (welded struct + fn round-trip), 1183/1184/1185
(layout-mismatch, unexported-fn, runtime-call diagnostics).
60 lines
2.1 KiB
Plaintext
60 lines
2.1 KiB
Plaintext
// Phase 0 baseline (PLAN-FFI.md step 0.6): sx function passed to C
|
|
// as a function pointer; C invokes it; sx-side observable effect.
|
|
// Mirrors the `app->onInputEvent` install pattern in
|
|
// library/modules/platform/android.sx.
|
|
//
|
|
// Two arities covered:
|
|
// 1. (i32) -> i32 — single-arg callback
|
|
// 2. (*void, i32) -> i32 — pointer + value (onInputEvent shape)
|
|
//
|
|
// Plus a side-effect via a global so we can confirm the callback
|
|
// actually fired (return value + state mutation both observable).
|
|
|
|
#import "modules/std.sx";
|
|
|
|
#import c {
|
|
#source "1214-ffi-06-callback.c";
|
|
};
|
|
|
|
ffi_apply_callback :: (cb: (i32) -> i32 abi(.c), value: i32) -> i32 extern;
|
|
ffi_apply_callback2 :: (cb: (*void, i32) -> i32 abi(.c), ctx: *void, v: i32) -> i32 extern;
|
|
|
|
g_callback_hits : i32 = 0;
|
|
g_callback_sum : i32 = 0;
|
|
|
|
double_it :: (x: i32) -> i32 abi(.c) {
|
|
g_callback_hits += 1;
|
|
g_callback_sum += x;
|
|
x * 2
|
|
}
|
|
|
|
add_with_ctx :: (ctx: *void, v: i32) -> i32 abi(.c) {
|
|
g_callback_hits += 1;
|
|
// Pass a sentinel via ctx to prove the pointer arg also survives the
|
|
// round-trip — read it back as an i32 through *i32.
|
|
p : *i32 = xx ctx;
|
|
p.* + v
|
|
}
|
|
|
|
main :: () -> i32 {
|
|
// ── Single-arg callback ────────────────────────────────────────
|
|
r1 := ffi_apply_callback(double_it, 21);
|
|
print("callback returned = {}\n", r1);
|
|
print("hits after first call = {}\n", g_callback_hits);
|
|
print("sum after first call = {}\n", g_callback_sum);
|
|
|
|
// Two more calls confirm the same fn pointer keeps working.
|
|
ffi_apply_callback(double_it, 7);
|
|
ffi_apply_callback(double_it, 11);
|
|
print("hits after three calls = {}\n", g_callback_hits);
|
|
print("sum after three calls = {}\n", g_callback_sum);
|
|
|
|
// ── Two-arg callback with opaque ctx pointer ───────────────────
|
|
ctx_val : i32 = 100;
|
|
r2 := ffi_apply_callback2(add_with_ctx, xx @ctx_val, 42);
|
|
print("ctx + value = {}\n", r2);
|
|
print("hits after ctx callback = {}\n", g_callback_hits);
|
|
|
|
0
|
|
}
|