Files
sx/examples/1217-ffi-09-foreign-result-chain.sx
agra bdd0e96d78 feat(lang): block value requires no trailing ; (Rust-style)
A block's value is now its last statement ONLY when that statement is a
trailing expression with no `;`. A trailing `;` discards the value,
leaving the block void. This makes value-vs-statement explicit and lets
the compiler reject "this block was supposed to produce a value".

Compiler:
- Parser records `Block.produces_value` (last stmt is a no-`;` trailing
  expression) + `Block.discarded_semi` (the `;` that discarded a value),
  via `expectSemicolonAfter`. A trailing expression before `}` may now
  omit its `;` (previously a parse error). Match-arm and else-arm bodies
  are built value-producing regardless of the arm `;` (arms are exempt —
  the `;` is an arm terminator).
- Lowering: `lowerBlockValue` / the block-expr path / `inferExprType`
  respect `produces_value`. A value-position block that discards its value
  is a hard error (`lowerValueBody` for function bodies; the value-context
  `.block` path for if/else branches, `catch` bodies, value bindings,
  match arms). Pure-failable `-> !` bodies (value rides the error channel)
  and a value-if whose branches are void are handled without false errors.
- `defer`/`onfail` cleanup bodies lower as statements (void), so a
  trailing `;` there is fine.

Migration (behavior-preserving — output unchanged):
- stdlib + ~210 examples: dropped the trailing `;` on value-position last
  expressions. `format` now ends with an explicit `#insert "return
  result;"` (it relied on `#insert`-as-block-value, which `;` discards).
- Two `main :: () -> s32` examples that relied on the old silent
  default-return got an explicit trailing `0`.
- Rejection snapshots 0412 / 1013 regenerated (their quoted source lines
  lost a `;`); the diagnostics themselves are unchanged.

Docs/tests: specs.md "Block values" section; examples 0040 (rules) + 0041
(rejection); 3 parser unit tests. Filed issue 0066 (pre-existing
match-arm negated-literal phi-width quirk, surfaced not caused here).

Gates: zig build, zig build test, run_examples.sh -> 343 passed,
cross_compile.sh -> 7 passed (also refreshed its stale example names).
2026-06-02 09:23:50 +03:00

80 lines
2.6 KiB
Plaintext

// Phase 0 baseline (PLAN-FFI.md step 0.9): FFI result chains. The
// shapes that real sx code uses for opaque C handles (MTLBuffer*,
// AAssetManager*, file pointers, ...) — passing a C-returned
// pointer into another C call, stashing it in a struct field,
// pushing into a `List(*void)`, and iterating that list to feed each
// handle back through C.
//
// No new ABI shape — pointer-in, pointer-out. The lemma locked in:
// handle-shaped flows survive sx's struct-field assignment, List
// storage, and iteration-then-call cycles.
#import "modules/std.sx";
#import c {
#include "1217-ffi-09-foreign-result-chain.h";
#source "1217-ffi-09-foreign-result-chain.c";
};
// Struct field hosts an FFI-returned handle.
Counter :: struct {
handle: *void = null;
label: string;
}
main :: () -> s32 {
// ── 1. Chain: make → bump → peek ───────────────────────────────
a := ffi_chain_make(100);
print("peek after make = {}\n", ffi_chain_peek(a));
print("bump(+5) = {}\n", ffi_chain_bump(a, 5));
print("bump(+3) = {}\n", ffi_chain_bump(a, 3));
print("peek after bumps = {}\n", ffi_chain_peek(a));
// ── 2. Stash handle in a struct field, use through `.handle` ──
c : Counter = .{ handle = ffi_chain_make(50), label = "ctr-a" };
print("ctr label = {}\n", c.label);
print("ctr peek = {}\n", ffi_chain_peek(c.handle));
ffi_chain_bump(c.handle, 7);
print("ctr after bump = {}\n", ffi_chain_peek(c.handle));
// ── 3. Push handles into a List, iterate, feed back to C ──────
handles : List(*void) = .{};
i : s32 = 0;
while i < 3 {
h := ffi_chain_make(i * 10);
handles.append(h);
i += 1;
}
j : s64 = 0;
while j < handles.len {
h := handles.items[j];
v := ffi_chain_peek(h);
print("list[{}] peek = {}\n", j, v);
j += 1;
}
// Iterate again, bump each, observe the cumulative effect.
j = 0;
while j < handles.len {
ffi_chain_bump(handles.items[j], 1);
j += 1;
}
j = 0;
while j < handles.len {
print("list[{}] after bump= {}\n", j, ffi_chain_peek(handles.items[j]));
j += 1;
}
// ── Cleanup ─────────────────────────────────────────────────────
ffi_chain_dispose(a);
ffi_chain_dispose(c.handle);
j = 0;
while j < handles.len {
ffi_chain_dispose(handles.items[j]);
j += 1;
}
0
}