Namaran

Code daily. Without assist.

2026-11-14

greet.zig

const std = @import("std");

fn greet(w: *std.Io.Writer, names: []const []const u8) !void {
    for (names) |name| try w.print("hello, {s}\n", .{name});
}

pub fn main(init: std.process.Init) !void {
    var buf: [64]u8 = undefined;
    const stdout_writer = std.Io.File.stdout().writer(init.io, &buf);
    var stdout = stdout_writer.interface;
    try greet(&stdout, &.{ "ann", "bob" });
    try stdout.flush();
}

greet で名前ごとに挨拶を1行ずつ標準出力へ書き、最後に flush するつもりのプログラムです。本来は hello, ann と hello, bob の2行を出力するはずが、いまは何も出力されず、手元の実行では flush の中で Segmentation fault になって止まります。

Answer

Wrong

    const stdout_writer = std.Io.File.stdout().writer(init.io, &buf);
    var stdout = stdout_writer.interface;
    try greet(&stdout, &.{ "ann", "bob" });

std.Io.Writer は、ファイルへの書き方を知っている std.Io.File.Writer の中に、interface というフィールドとして埋め込まれています。バッファが足りなくなったときや flush で実際に書き出す処理は、受け取った *std.Io.Writer から @fieldParentPtr でそれを含む File.Writer の位置を逆算し、そこにあるファイルや io を使います。

var stdout = stdout_writer.interface; は、そのフィールドを別の変数へ値としてコピーします。コピーはどの File.Writer の中にもないので、flush が逆算した位置にあるのは、スタック上の関係のないバイトです。それをファイルや io として使った時点で illegal behavior になり、手元では不正なアドレスを読んで落ちました。print はバッファに書くだけで済んでいたので、ここまでは何事もなく進みます。stdout_writer を const にしているのは、var のままだと、一度も書き換えない変数としてコンパイルエラーになるからです。

Right

    var stdout_writer = std.Io.File.stdout().writer(init.io, &buf);
    const stdout = &stdout_writer.interface;
    try greet(stdout, &.{ "ann", "bob" });

&stdout_writer.interface で、File.Writer の中にあるフィールドそのものを指すポインタを取ります。flush の逆算はこのポインタから正しい File.Writer にたどり着き、たまった2行を標準出力へ書き出します。interface を通して書き込むとバッファの位置などが書き換わるので、stdout_writer は var になります。