diff --git a/src/backend/Assembly.zig b/src/backend/Assembly.zig index 15aa86557b7d961d653f4104c0f8b3484fb5e2a3..5e34c1e77f58c9ba00465a80be4661fccac7ae4a 100644 --- a/src/backend/Assembly.zig +++ b/src/backend/Assembly.zig @@ -11,12 +11,17 @@ pub fn deinit(self: *const Assembly, gpa: Allocator) void { gpa.free(self.text); } -/// 将汇编数据写入文件 -/// 将 Assembly 结构体的 data 和 text 字段内容写入到指定的文件中 -/// 使用 scatter-gather I/O 方式同时写入两个数据段 -/// @param self Assembly 实例,包含 data 和 text 数据 -/// @param file 目标文件句柄 -/// @return 如果写入成功返回 void,如果发生错误则返回错误类型 +/// 将 Assembly 结构体的 `data` 和 `text` 字段内容写入到指定的文件中。 +/// 使用 scatter-gather I/O 方式同时写入两个数据段,提高 I/O 效率。 +/// +/// ## 参数 +/// +/// - `self`: Assembly 实例,包含 `data` 和 `text` 数据 +/// - `file`: 目标文件句柄 +/// +/// ## 返回值 +/// +/// 如果写入成功返回 `void`,如果发生错误则返回错误类型 pub fn writeToAllFile(self: Assembly, file: std.fs.File) !void { var vec: [2]std.posix.iovec_const = .{ .{ .base = self.data.ptr, .len = self.data.len },