Files
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

4.0 KiB
Executable File

markup, title, description
markup title description
occlusion lib/正则 正则表达式(中层 M1)。Unicode;无回溯引用。

正则表达式。Unicode;无回溯引用。字面替换请用 lib/文本。

进行 Unicode 正则匹配。

能力与边界:不支持反向引用;当前查找返回完整匹配,不承诺捕获组对象或替换回调。字面字符串替换使用文本库。

本文件就是调用和开发手册:直接导入此文件,或用 marqdo call 按下面的函数标题调用。参数表说明类型和默认值;未填默认值的参数必须提供。返回表是渐进契约,后文说明失败与边界。

实现入口:src/host/re.rs

开发时保持中英文语义一致,先组合公开库;仅在 OS 或算法边界添加宿主原语并声明效应。修改后运行 marqdo check --narrative-ratio 本文件,并执行 tests/stdlib_tasks.rs 的真实任务。

匹配

参数 类型 默认 说明
内容 any 必填 本操作读取、转换或输出的文本
模式 any 必填 宿主 regex 实现支持的正则表达式
返回 类型 说明
result bool 内容是否匹配模式

这里使用内容、模式。

调用效应:pure。

内容是否匹配模式。

调用例:[正则.匹配] 内容=s 模式="a+"

完成后返回*[内容是否匹配模式](> host_re_is_match text=内容 pattern=模式)*。

查找

参数 类型 默认 说明
内容 any 必填 本操作读取、转换或输出的文本
模式 any 必填 宿主 regex 实现支持的正则表达式
返回 类型 说明
result any 在内容中查找模式的首个匹配;没有 → None

这里使用内容、模式。

调用效应:pure。

在内容中查找模式的首个匹配;没有 → None。

完成后返回*[在内容中查找模式的首个匹配;没有 → None](> host_re_find text=内容 pattern=模式)*。

查找全部

参数 类型 默认 说明
内容 any 必填 本操作读取、转换或输出的文本
模式 any 必填 宿主 regex 实现支持的正则表达式
返回 类型 说明
result list 在内容中查找模式的全部匹配

这里使用内容、模式。

调用效应:pure。

直接调用此函数:

marqdo call lib/正则.mq.md 查找全部 '内容="a12 b34"' '模式="[0-9]+"' --effects none --json

在内容中查找模式的全部匹配。

完成后返回*[在内容中查找模式的全部匹配](> host_re_find_all text=内容 pattern=模式)*。

替换

参数 类型 默认 说明
内容 any 必填 本操作读取、转换或输出的文本
模式 any 必填 宿主 regex 实现支持的正则表达式
为 any 必填 替换匹配片段所用的文本
次数 any None 最大替换次数;None 使用操作说明中的默认值
返回 类型 说明
result text 用为替换内容中匹配模式的部分;可选次数限制(缺省 = 全部)

这里使用内容、模式、为、次数=None。

调用效应:pure。

用为替换内容中匹配模式的部分;可选次数限制(缺省 = 全部)。

完成后返回*[用为替换内容中匹配模式的部分;可选次数限制(缺省 = 全部)](> host_re_replace text=内容 pattern=模式 with=为 count=次数)*。

拆分

参数 类型 默认 说明
内容 any 必填 本操作读取、转换或输出的文本
模式 any 必填 宿主 regex 实现支持的正则表达式
返回 类型 说明
result list 按模式拆分内容

这里使用内容、模式。

调用效应:pure。

按模式拆分内容。

完成后返回*[按模式拆分内容](> host_re_split text=内容 pattern=模式)*。