Localized V2 rewrite for this language is in progress. Showing English-first content for now.

标准库

stdlib 概览、如何导入模块,以及如何生成 API 文档。

标准库

Sounio 的标准库位于仓库的 stdlib/ 目录。它提供核心数据结构、I/O、数学,以及领域模块(认识论计算、科学计算等)。

导入模块

Sounio 支持 useimport 两种形式(在许多情况下 parser 都接受)。

在测试与示例中常见的写法:

use math::*
import stdlib.math.*

实用提示: 不确定时,直接在仓库里搜索你要用的模块,并复制其使用的 import 形式。

建议先读哪些

  • stdlib/core/: Option<T>, Result<T, E>, 基础 traits
  • stdlib/io/: 控制台 + 文件系统 API
  • stdlib/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,否则不要提交)。

下一步