- 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。
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=模式)*。