如何解决Zig语言中无符号值错误？终端Raw模式代码报错

问题代码 #

我编写了一段将终端设置为Raw模式的Zig代码：

const std = @import("std");
const stdio = @cImport({
    @cInclude("stdio.h");
});

const ioctl = @cImport({
    @cInclude("sys/ioctl.h");
    @cInclude("stdio.h");
    @cInclude("unistd.h");
    @cInclude("errno.h");
    @cInclude("termios.h");
});


pub fn main() !void {
    var t = ioctl.termios {};

    const is_terminal = ioctl.ioctl(0, ioctl.TIOCGETA, t);
    if (is_terminal == 0) {
        t.c_iflag &= @intCast(@as(c_long, @intCast(~(ioctl.IGNBRK
            | ioctl.BRKINT
            | ioctl.PARMRK
            | ioctl.ISTRIP
            | ioctl.INLCR
            | ioctl.IGNCR
            | ioctl.ICRNL
            | ioctl.IXON))));

        t.c_oflag &= ~ioctl.OPOST;
        t.c_lflag &= ~(ioctl.ECHO | ioctl.ECHONL | ioctl.ICANON | ioctl.ISIG | ioctl.IEXTEN);
        t.c_cflag &= ~(ioctl.CSIZE | ioctl.PARENB);
        t.c_cflag |= ioctl.CS8;
        t.c_cc[ioctl.VMIN] = 1;
        t.c_cc[ioctl.VTIME] = 0;

        ioctl.ioctl(0, ioctl.TIOCSETA, t);
    }

    std.debug.print("Hello {any}.", .{ is_terminal });
}

编译报错 #

该代码对应的Java版本（通过jextract生成）可正常运行，但Zig版本编译失败，报错信息：

main.zig:46:31: error: type 'c_ulong' cannot represent integer value '-1004'
        t.c_iflag &= @intCast(@as(c_long, @intCast(~(ioctl.IGNBRK
                              ^~~
referenced by:
    main: /Users/emccue/Library/zig/0.15.0-dev.375+8f8f37fb0/lib/std/start.zig:671:37
    comptime: /Users/emccue/Library/zig/0.15.0-dev.375+8f8f37fb0/lib/std/start.zig:58:30
    2 reference(s) hidden; use '-freference-trace=4' to see all references

问题原因 #

c_iflag属于无符号类型（c_ulong），但代码中先将位掩码取反后转成了有符号的c_long，取反操作导致结果为负数，而无符号类型无法表示负数，因此触发编译错误。

修复方案 #

1. 修正位操作的类型匹配 #

直接基于目标字段的类型处理位掩码，避免转成有符号类型：
将原来的c_iflag赋值行修改为：

t.c_iflag &= ~(@as(@TypeOf(t.c_iflag), ioctl.IGNBRK
    | ioctl.BRKINT
    | ioctl.PARMRK
    | ioctl.ISTRIP
    | ioctl.INLCR
    | ioctl.IGNCR
    | ioctl.ICRNL
    | ioctl.IXON));

这里用@TypeOf(t.c_iflag)获取目标类型，确保掩码取反后是合法的无符号值。其他字段的位操作也可以统一用这个方式处理，避免类型不匹配问题。

2. 修复ioctl的传参错误 #

TIOCGETA和TIOCSETA需要接收struct termios*类型的指针，原代码直接传t会导致未定义行为，需要改为传指针：

const is_terminal = ioctl.ioctl(0, ioctl.TIOCGETA, &t);
// ...
ioctl.ioctl(0, ioctl.TIOCSETA, &t);

完整修复后的代码 #

const std = @import("std");
const stdio = @cImport({
    @cInclude("stdio.h");
});

const ioctl = @cImport({
    @cInclude("sys/ioctl.h");
    @cInclude("stdio.h");
    @cInclude("unistd.h");
    @cInclude("errno.h");
    @cInclude("termios.h");
});


pub fn main() !void {
    var t = ioctl.termios {};

    const is_terminal = ioctl.ioctl(0, ioctl.TIOCGETA, &t);
    if (is_terminal == 0) {
        // 修正c_iflag的位操作类型
        t.c_iflag &= ~(@as(@TypeOf(t.c_iflag), ioctl.IGNBRK
            | ioctl.BRKINT
            | ioctl.PARMRK
            | ioctl.ISTRIP
            | ioctl.INLCR
            | ioctl.IGNCR
            | ioctl.ICRNL
            | ioctl.IXON));

        t.c_oflag &= ~@as(@TypeOf(t.c_oflag), ioctl.OPOST);
        t.c_lflag &= ~(@as(@TypeOf(t.c_lflag), ioctl.ECHO | ioctl.ECHONL | ioctl.ICANON | ioctl.ISIG | ioctl.IEXTEN));
        t.c_cflag &= ~(@as(@TypeOf(t.c_cflag), ioctl.CSIZE | ioctl.PARENB));
        t.c_cflag |= @as(@TypeOf(t.c_cflag), ioctl.CS8);
        t.c_cc[ioctl.VMIN] = 1;
        t.c_cc[ioctl.VTIME] = 0;

        ioctl.ioctl(0, ioctl.TIOCSETA, &t);
    }

    std.debug.print("Hello {any}.", .{ is_terminal });
}

内容的提问来源于stack exchange，提问作者Ethan McCue