跳转到内容

std.process.Preopens

标准库Zig 0.17.0官方原文
源码std/process/Preopens.zig

第 1 行

字段

map: Map

std.process.Preopens.Allocator

别名

第 8 行

别名目标 std.mem.Allocator

std.process.Preopens.builtin

常量

第 3 行

std.process.Preopens.empty

常量

第 12 行

Preopens

std.process.Preopens.get

函数

第 28 行

pub fn get(p: *const Preopens, name: []const u8) ?Resource

参数

p: *const Preopens
name: []const u8

std.process.Preopens.init

函数

第 49 行

pub fn init(arena: Allocator) InitError!Preopens

参数

arena: Allocator

错误

OutOfMemory Error
Unexpected

std.process.Preopens.InitError

错误集合

第 47 行

错误

OutOfMemory Error
Unexpected

std.process.Preopens.Io

别名

第 7 行

别名目标 std.Io

std.process.Preopens.Map

类型

第 17 行

std.process.Preopens.native_os

常量

第 4 行

std.process.Preopens.Preopens

别名

第 1 行

别名目标 std.process.Preopens

std.process.Preopens.Resource

容器

第 23 行

字段

file: Io.File
dir: Io.Dir

std.process.Preopens.std

别名

第 6 行

别名目标 std

源码

std/process/Preopens.zig

const Preopens = @This();

const builtin = @import("builtin");
const native_os = builtin.os.tag;

const std = @import("../std.zig");
const Io = std.Io;
const Allocator = std.mem.Allocator;

map: Map,

pub const empty: Preopens = switch (native_os) {
    .wasi => .{ .map = .empty },
    else => .{ .map = {} },
};

pub const Map = switch (native_os) {
    // 按文件描述符编号索引。
    .wasi => std.array_hash_map.String(void),
    else => void,
};

pub const Resource = union(enum) {
    file: Io.File,
    dir: Io.Dir,
};

pub fn get(p: *const Preopens, name: []const u8) ?Resource {
    switch (native_os) {
        .wasi => {
            const index = p.map.getIndex(name) orelse return null;
            if (index <= 2) return .{ .file = .{
                .handle = @intCast(index),
                .flags = .{ .nonblocking = false },
            } };
            return .{ .dir = .{ .handle = @intCast(index) } };
        },
        else => {
            if (std.mem.eql(u8, name, "stdin")) return .{ .file = .stdin() };
            if (std.mem.eql(u8, name, "stdout")) return .{ .file = .stdout() };
            if (std.mem.eql(u8, name, "stderr")) return .{ .file = .stderr() };
            return null;
        },
    }
}

pub const InitError = Allocator.Error || error{Unexpected};

pub fn init(arena: Allocator) InitError!Preopens {
    if (native_os != .wasi) return .{ .map = {} };
    const wasi = std.os.wasi;
    var map: Map = .empty;

    try map.ensureUnusedCapacity(arena, 3);

    map.putAssumeCapacityNoClobber("stdin", {}); // 0
    map.putAssumeCapacityNoClobber("stdout", {}); // 1
    map.putAssumeCapacityNoClobber("stderr", {}); // 2
    while (true) {
        const fd: wasi.fd_t = @intCast(map.entries.len);
        var prestat: wasi.prestat_t = undefined;
        switch (wasi.fd_prestat_get(fd, &prestat)) {
            .SUCCESS => {},
            .OPNOTSUPP, .BADF => return .{ .map = map },
            else => return error.Unexpected,
        }
        try map.ensureUnusedCapacity(arena, 1);
        // 此长度不包含空字节。保留这种形式,以温和地促使 WASI 实现正确运行。
        //
        const name_len = prestat.u.dir.pr_name_len;
        const name = try arena.alloc(u8, name_len);
        switch (wasi.fd_prestat_dir_name(fd, name.ptr, name.len)) {
            .SUCCESS => {},
            else => return error.Unexpected,
        }
        map.putAssumeCapacityNoClobber(name, {});
    }
}