Files
sx/examples/ffi-05-string-args.sx
agra 3855f2351e ffi: move test-companion .c/.h next to their .sx (drop vendors/ namespace)
vendors/ is a third-party namespace (stb_image, kb_text_shape, etc.);
test fixtures don't belong there. The .c/.h companion files for the
Phase-0 FFI baselines now sit alongside the .sx that drives them in
examples/, with matching basenames:

  examples/ffi-01-primitives.{sx,c,h}    <- was vendors/ffi_primitives/
  examples/ffi-02-small-struct.{sx,c,h}  <- was vendors/ffi_structs/
  examples/ffi-03-large-struct.{sx,c,h}  <- was vendors/ffi_large_struct/
  examples/ffi-04-fp-struct.{sx,c,h}     <- was vendors/ffi_fp_struct/
  examples/ffi-05-string-args.{sx,c,h}   <- was vendors/ffi_strings/
  examples/ffi-06-callback.{sx,c,h}      <- was vendors/ffi_callback/
  examples/101-ffi-medium-struct.{sx,c}  <- was vendors/ffi_medium_struct/

`#source` / `#include` paths in the .sx files become bare filenames
(no prefix) since imports.zig's base_dir resolution finds them
relative to the importing .sx file's directory.

`library/vendors/sx_ffi_resolve_test/` stays put — that one's the
whole point: regression coverage for the stdlib-search branch of
the resolution chain, so it must live where ONLY that branch can
find it.

94/94 regression tests pass.
2026-05-19 11:54:36 +03:00

50 lines
2.2 KiB
Plaintext

// Phase 0 baseline (PLAN-FFI.md step 0.5): the three shapes that
// actually appear at the sx ↔ C boundary today:
//
// 1. Null-terminated `[:0]u8` — passed by `.ptr` to a `const char *`.
// 2. Raw byte buffer `[*]u8` — pointer + explicit length.
// 3. sx `string` value — coerceArg's "fat-pointer decay" branch
// pulls `.ptr` automatically for `*u8`/
// `[:0]u8` params (string is `{ptr, len}`).
// 4. Pointer return from C — round-trips back as `[*]u8` / `*u8`.
#import "modules/std.sx";
#import c {
#source "ffi-05-string-args.c";
};
ffi_strlen :: (s: [:0]u8) -> s32 #foreign;
ffi_first_byte :: (s: [:0]u8) -> s32 #foreign;
ffi_sum_bytes :: (buf: [*]u8, len: s32) -> s32 #foreign;
ffi_write_byte :: (buf: [*]u8, idx: s32, v: u8) -> void #foreign;
ffi_static_greeting :: () -> [*]u8 #foreign;
main :: () -> s32 {
// ── [:0]u8 null-terminated literal ─────────────────────────────
msg : [:0]u8 = "hello";
print("strlen(\"hello\") = {}\n", ffi_strlen(msg));
print("first_byte = {}\n", ffi_first_byte(msg));
// ── sx `string` → C `const char *` (slice-decay through coerceArg) ─
s : string = "sx string here";
print("strlen(sx string) = {}\n", ffi_strlen(xx s.ptr));
// ── [*]u8 raw buffer + length ──────────────────────────────────
bytes : [4]u8 = .[10, 20, 30, 40];
bp : [*]u8 = xx @bytes[0];
print("sum_bytes([10,20,30,40]) = {}\n", ffi_sum_bytes(bp, 4));
// ── Mutate buffer via C, read back from sx ─────────────────────
ffi_write_byte(bp, 1, 99);
print("bytes[1] after write = {}\n", bytes[1]);
// ── C returns a static string pointer; read it byte-by-byte ────
g := ffi_static_greeting();
n := ffi_strlen(xx g);
print("static greeting len = {}\n", n);
print("static greeting [0] = {}\n", g[0]);
0;
}