Rust sys
模块文档
模块概述
提供与环境变量操作相关的核心内置函数集合,用于实现运行时环境管理。
help sys |
环境变量相关函数列表
2. env
- 功能:获取顶级作用域环境的变量列表
- 参数:无
- 返回值:
Environment
类型的映射结构 - 示例:
(env)
→ 返回顶级作用域的所有绑定
3. vars
- 功能:获取当前环境的变量列表
- 参数:无
- 返回值:包含
(变量名 → 值)
映射的哈希表
4. set
- 功能:定义/修改顶级作用域变量
- 参数:
(set name value)
name
:字符串类型的变量名value
:任意表达式
- 返回值:
Expression::None
- 错误:参数数量不为2时抛出异常
5. unset
- 功能:删除顶级作用域变量定义
- 参数:
(unset name)
name
:字符串类型的变量名
- 返回值:
Expression::None
- 错误:参数数量不为1时抛出异常
6. defined
- 功能:在当前和父级作用域中,检查变量是否定义
- 参数:
(defined name)
name
:字符串类型的变量名
- 返回值:
Boolean
类型(true表示已定义) - 错误:参数数量不为1时抛出异常
6. has
- 功能:在当前作用域中,检查变量是否定义
- 参数:
(defined name)
name
:字符串类型的变量名
- 返回值:
Boolean
类型(true表示已定义) - 错误:参数数量不为1时抛出异常
环境变量相关函数列表
1. err_codes
- 功能:获取运行时错误代码表
- 参数:无
- 返回值:包含
(错误码 → 描述)
映射的哈希表 - 用途:调试时查询错误类型
2. quote
- 功能:创建表达式的引用(防止求值)
- 参数:
(quote expr)
expr
:任意表达式
- 返回值:
Quote
类型(包含原始表达式的不可变引用) - 错误:参数数量不为1时抛出异常
2. print_tty
- 功能:向tty写入控制指令
- 参数:
(quote expr)
String
:字符表达式
- 返回值:
None
类型 - 错误:参数数量不为1时抛出异常
2. discard
- 功能:将数据发送到 /dev/null
- 参数:
(quote expr)
expr
:任意表达式
- 返回值:
Quote
类型(包含原始表达式的不可变引用)