参考

标准库参考

可运行模块、分配行为、能力和辅助元数据。

标准库参考

Zero 的标准库按需使用且具备能力感知。导入内存辅助工具不会引入托管文件系统辅助工具。

托管 API 会在 zero graphzero size 中报告其目标平台需求。

可运行模块:

  • std.mem:跨度、字节相等性、复制/填充、固定缓冲区分配器、字节缓冲区和竞技场式重置辅助工具。
  • std.io:缓冲读取器/写入器元数据以及基于调用者所有存储的字节复制辅助工具。
  • std.args:托管进程参数计数和索引查找。
  • std.env:托管环境变量查找。
  • std.fs:托管文件生命周期辅助工具、拥有的文件句柄、字节读/写、删除、重命名和关闭。
  • std.path:固定缓冲区路径拼接。
  • std.parse:无分配的 ASCII 扫描器和无符号整数解析器。
  • std.codec:面向字节的整数编码、变长整数长度和 CRC-32 辅助工具。
  • std.json:字符串和字节跨度验证、流式令牌计数、显式分配器解析和调用者缓冲区字符串写入。
  • std.time:时长运算以及目标平台门控的单调时钟和挂钟辅助工具。
  • std.rand:显式确定性随机源和目标平台熵辅助工具。
  • std.proc:进程能力背后的宿主进程状态辅助工具。
  • std.crypto:小型哈希、密钥哈希、常量时间相等性和熵辅助工具。
  • std.net:网络能力元数据和引导连接/监听器句柄。
  • std.http:HTTP 方法、正文长度、客户端/服务器元数据、TLS 边界辅助工具、托管 GET 便捷函数、原始请求信封辅助工具、原始响应头捕获和头部值查找。

每个模块页面记录了目标平台支持、分配行为、错误行为、所有权说明和可运行示例。

使用 CLI 检查程序实际保留的内容:

命令显示内容
zero graph --json <input>所需能力和已导入的辅助工具。
zero size --json <input>辅助工具元数据和保留的辅助工具开销。
zero mem --json <input>memoryBudgetsallocatorFactsallocationInstrumentationcollectionFacts

stdlibHelpersusedStdlibHelpers JSON 条目包含每个公共辅助工具的 moduleeffectsallocationBehaviortargetSupporterrorBehaviorownershipNotesexampleapiStability

元数据契约

公共标准库符号记录了代理安全调用它们所需的字段:

symbol: std.fs.readAllOrRaise
effects: fs
allocation behavior: caller allocator
target support: host
error behavior: `![NotFound TooLarge Io]`
ownership notes: returns owned<ByteBuf>
example: examples/readall-cli/

当相关符号的元数据相同时,模块页面可以将其分组。

请保持以下标签可见:effects、allocation behavior、target support、error behavior、ownership notes 和 example。