Lumesh Sys 模块

wiki libs

Rust sys 模块文档

模块概述

提供与环境变量操作相关的核心内置函数集合,用于实现运行时环境管理。

help sys

+-------------------------------------------------------------------------------------+
| KEY VALUE |
+=====================================================================================+
| has Builtin@has check if a variable is defined in current environment |
| env Builtin@env get root environment as a map |
| defined Builtin@defined check if a variable is defined in current environment |
| tree |
| set Builtin@set define a variable in root environment |
| err_codes Builtin@err_codes display runtime error codes |
| vars Builtin@vars get defined variables in current enviroment |
| discard Builtin@discard send data to /dev/null |
| print_tty Builtin@print_tty print control sequence to tty |
| quote Builtin@quote quote an expression |
| unset Builtin@unset undefine a variable in root environment |
+-------------------------------------------------------------------------------------+


环境变量相关函数列表

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类型(包含原始表达式的不可变引用)