如何在Zig中安全进行整数类型转换？是否有安全转换函数？

Zig本身没有内置的@safeIntCast函数，但可以通过标准库工具或自定义逻辑实现安全的整数转换，避免@intCast在溢出时触发的未定义行为：

1. 用std.math.cast返回可选类型 #

这是标准库提供的最直接的安全转换方式，当目标类型存不下源值时，它会返回null而非产生未定义行为。举个例子：

const std = @import("std");
const expect = std.testing.expect;

test "安全整数转换（可选类型）" {
    const big_num: i32 = 300;
    // 尝试转成u8，300超过u8最大值255，返回null
    const cast_result = std.math.cast(u8, big_num);
    try expect(cast_result == null);

    const small_num: i32 = 100;
    const valid_result = std.math.cast(u8, small_num);
    try expect(valid_result.? == 100);
}

2. 封装返回错误联合的自定义函数 #

如果需要明确返回错误而非可选值，可以基于std.math.cast封装一个返回错误联合的函数，比如：

const std = @import("std");
const CastError = error{Overflow};

fn safeIntCast(comptime TargetType: type, source_value: anytype) CastError!TargetType {
    if (std.math.cast(TargetType, source_value)) |casted_val| {
        return casted_val;
    } else {
        return error.Overflow;
    }
}

test "安全整数转换（错误联合）" {
    const overflow_num: i64 = 1 << 32;
    // 转成u32会溢出，返回Overflow错误
    const err_result = safeIntCast(u32, overflow_num);
    try expect(err_result == error.Overflow);

    const valid_num: i64 = 200;
    const ok_result = try safeIntCast(u32, valid_num);
    try expect(ok_result == 200);
}

补充说明 #

内置的@intCast是为高性能场景设计的，它默认假设开发者已经确认转换不会溢出，所以不做安全检查。如果需要安全保障，必须依赖标准库或自定义的检查逻辑，目前Zig没有内置的直接返回错误联合的安全转换函数。

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