标准库
stdlib 概览、如何导入模块,以及如何生成 API 文档。
标准库
Sounio 的标准库位于仓库的 stdlib/ 目录。它提供核心数据结构、I/O、数学,以及领域模块(认识论计算、科学计算等)。
导入模块
Sounio 支持 use 与 import 两种形式(在许多情况下 parser 都接受)。
在测试与示例中常见的写法:
use math::*
import stdlib.math.*
实用提示: 不确定时,直接在仓库里搜索你要用的模块,并复制其使用的 import 形式。
建议先读哪些
stdlib/core/:Option<T>,Result<T, E>, 基础 traitsstdlib/io/: 控制台 + 文件系统 APIstdlib/math/: 标量数学工具stdlib/collections/:Vec、map/set(在可用时)stdlib/epistemic/:Knowledge<T>的设计与语义
API 文档(生成)
仓库包含一个文档生成器:
# Generate HTML docs for stdlib into a directory
cargo run --bin souniodoc -- generate stdlib --output website/public/api
然后启动网站并访问 /api/。
注意: 生成文件通常应视为构建产物(除非你明确要 vendoring,否则不要提交)。