普贤教程 › 包参考

xmlstream 包

流式 XML 读写

项	值
包名	`xmlstream`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`xmlstream.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 235`

安装与引入

bash

pxpkg init          # 首次
pxpkg add xmlstream@0.2.0
pxpkg install

import xmlstream

所属分类教程：数据格式与编解码

公开接口

函数	参数
`xr_reset`	`r`
`xr_pos`	`r`
`xr_is_done`	`r`
`xr_read_all`	`r`
`xr_peek`	`r`

其余 18 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`xw_new`
`xw_start_document`	`w`
`xw_start_element`	`w, name, attrs`
`xw_end_element`	`w, name`
`xw_write_element`	`w, name, content`
`xw_text`	`w, text`
`xw_comment`	`w, text`
`xw_write_cdata`	`w, text`
`xw_write_raw`	`w, raw_xml`
`xw_end_document`	`w`
`xw_get_output`	`w`
`xw_escape_text`	`s`
`xw_escape_attr`	`s`
`_xs_find_from`	`s, ch, start`
`_xs_find_str`	`s, sub, start`
`_xs_parse_attrs`	`attr_str`
`xr_new`	`xml`
`xr_read_next`	`r`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/xmlstream — 流式 XML 读写
------------------------------------------------------------
纯函数库，双模式一致。

实现要点：
- 读到末尾先把 _pos 推到 len(xml) 再返回 null ⇒ xr_is_done() 与返回值口径一致。
- CDATA 单独成事件：{type: "cdata", text: ...}，内部 ">" 不再误判。
- 空标签名 / 残缺标签返回 {type: "text"} 或 null，不崩。
- 新增 xr_read_all(r) → 一次性取完所有事件、xr_reset(r)、xr_pos(r)、xr_peek(r)。

读事件形态：
{type: "start",  name, attrs, self_closing}
{type: "end",    name}
{type: "pi",     text}
{type: "comment", text}
{type: "cdata",  text}
{type: "text",   text}     # 新增：标签之间的文本
读到文件末尾返回 null。
============================================================