std::env 使用方法

提供环境变量查询和工作目录控制。

导入

import("std::env::environ");
import("std::env::cwd");
import("std::env::consts");

1. 读取字符串环境变量

fun main() {
    var buf: array<u8, 256>;
    var n: i64 = env_get("HOME", &buf[0], 256);

    if (n >= 0) {
        // buf 是一个以 NUL 结尾的字符串
    } else if (n == ENV_ERR_NOT_FOUND) {
        // 没有钥匙
    } else if (n == ENV_ERR_NO_SPACE) {
        // 缓冲区溢出
    }
}

2. 读取整数环境变量（泛型结果类型）

fun main() {
    var port_res: EnvResult<i32> = env_get_i32("PORT");
    var port: i32 = env_unwrap_or<i32>(port_res, 8080);

    var workers: i64 = env_get_i64_default("WORKERS", 4);
}

3. 当前目录/移动

fun main() {
    var cwd: array<u8, 512>;
    var n: i64 = env_getcwd(&cwd[0], 512);

    if (n >= 0) {
        env_chdir("/tmp");
    }
}

主要函数

fun env_get(name: str, dst: ptr<u8>, dst_cap: i64) -> i64
fun env_exists(name: str) -> bool
fun env_get_i32(name: str) -> EnvResult<i32>
fun env_get_i64(name: str) -> EnvResult<i64>
fun env_get_i32_default(name: str, default_value: i32) -> i32
fun env_get_i64_default(name: str, default_value: i64) -> i64
fun env_getcwd(dst: ptr<u8>, cap: i64) -> i64
fun env_chdir(path: str) -> i64
fun env_access(path: str, mode: i32) -> i64