One Markdown-to-program mapping, no version selector or legacy mapper. Frontend/runtime: - resolve @exec/@knowledge heading declarations with nearest-ancestor inheritance; only an Exec H2 is callable; add UnitKind::Knowledge and sem.* diagnostics (mode marker, unit name, exec-without-function, payload nesting/empty, syntax, control stack, params position, version directive, inferred-signature lint) - extract Strong/Emph/inline Code as one-statement carriers, refuse nested carriers, and honour heading segment boundaries so an if/while cannot be closed across a heading - lower if/else/while/end to the existing Branch/Loop/Return IR with a compile-time control stack; keep payload-relative source spans through expression parsing and rewrite them onto the file - accept params(...) only as the first direct Exec H2 payload; keep the existing free-variable inference and named-only rule for inferred signatures; fix duplicate-mode/else/end and Knowledge-body inertness - reject marqdo_semantics/syntax front matter directives Data and tests: - migrate stdlib/**/*.mq.md, regenerate stdlib.json digest - migrate examples and the full semantics/negative/runtime corpus to the only current syntax; expected values/runtime codes preserved - migrate Rust-embedded .mq.md fixtures, init template, CLI help and security-lane fixtures Verified: cargo fmt --check, cargo clippy -D warnings and cargo test --workspace --locked (green).
4.2 KiB
@exec utf8
成功
params(值)
return {ok: true, value: 值}
失败
params(代码, 消息)
return {ok: false, code: 代码, message: 消息}
续字节
params(字节)
return 字节 >= 128 and 字节 < 192
编码
params(文本, 内存, 基址)
把 Unicode 标量序列按 UTF-8 写入 Memory,返回字节长度。 这是 .mq.md 自己实现的编码逻辑,不是 Rust 内建 UTF-8 转换。
点 = text.codepoints(文本)
下标 = 0
偏移 = 0
while 下标 < 长度(点)
码点 = 点[下标]
if 码点 < 128
内存[基址 + 偏移] = 码点
偏移 = 偏移 + 1
else
if 码点 < 2048
内存[基址 + 偏移] = 192 + 码点 // 64
内存[基址 + 偏移 + 1] = 128 + 码点 % 64
偏移 = 偏移 + 2
else
if 码点 < 65536
内存[基址 + 偏移] = 224 + 码点 // 4096
内存[基址 + 偏移 + 1] = 128 + 码点 // 64 % 64
内存[基址 + 偏移 + 2] = 128 + 码点 % 64
偏移 = 偏移 + 3
else
if true
内存[基址 + 偏移] = 240 + 码点 // 262144
内存[基址 + 偏移 + 1] = 128 + 码点 // 4096 % 64
内存[基址 + 偏移 + 2] = 128 + 码点 // 64 % 64
内存[基址 + 偏移 + 3] = 128 + 码点 % 64
偏移 = 偏移 + 4
end
end
end
end
下标 = 下标 + 1
end
return 偏移
解码2
params(内存, 基址, 长度, 偏移, 文本)
if 偏移 + 1 >= 长度
return [文本, 偏移, "utf8.truncated"]
end
b1 = 内存[基址 + 偏移 + 1]
if not 续字节(b1)
return [文本, 偏移, "utf8.invalid_continuation"]
end
码点 = (内存[基址 + 偏移] - 192) * 64 + (b1 - 128)
if 码点 < 128
return [文本, 偏移, "utf8.invalid_scalar"]
end
return [文本 + text.from_codepoint(码点), 偏移 + 2, ""]
解码3
params(内存, 基址, 长度, 偏移, 文本)
if 偏移 + 2 >= 长度
return [文本, 偏移, "utf8.truncated"]
end
b1 = 内存[基址 + 偏移 + 1]
b2 = 内存[基址 + 偏移 + 2]
if not (续字节(b1) and 续字节(b2))
return [文本, 偏移, "utf8.invalid_continuation"]
end
码点 = (内存[基址 + 偏移] - 224) * 4096 + (b1 - 128) * 64 + (b2 - 128)
if 码点 < 2048 or (码点 >= 55296 and 码点 <= 57343)
return [文本, 偏移, "utf8.invalid_scalar"]
end
return [文本 + text.from_codepoint(码点), 偏移 + 3, ""]
解码4
params(内存, 基址, 长度, 偏移, 文本)
if 偏移 + 3 >= 长度
return [文本, 偏移, "utf8.truncated"]
end
b1 = 内存[基址 + 偏移 + 1]
b2 = 内存[基址 + 偏移 + 2]
b3 = 内存[基址 + 偏移 + 3]
if not (续字节(b1) and 续字节(b2) and 续字节(b3))
return [文本, 偏移, "utf8.invalid_continuation"]
end
码点 = (内存[基址 + 偏移] - 240) * 262144 + (b1 - 128) * 4096 + (b2 - 128) * 64 + (b3 - 128)
if 码点 < 65536 or 码点 > 1114111
return [文本, 偏移, "utf8.invalid_scalar"]
end
return [文本 + text.from_codepoint(码点), 偏移 + 4, ""]
解码
params(内存, 基址, 长度)
偏移 = 0
文本 = ""
错误 = ""
while 偏移 < 长度 and 错误 == ""
首 = 内存[基址 + 偏移]
if 首 < 128
文本 = 文本 + text.from_codepoint(首)
偏移 = 偏移 + 1
else
if 首 < 194
错误 = "utf8.invalid_lead"
else
if 首 < 224
结果 = 解码2(内存, 基址, 长度, 偏移, 文本)
文本 = 结果[0]
偏移 = 结果[1]
错误 = 结果[2]
else
if 首 < 240
结果 = 解码3(内存, 基址, 长度, 偏移, 文本)
文本 = 结果[0]
偏移 = 结果[1]
错误 = 结果[2]
else
if 首 < 245
结果 = 解码4(内存, 基址, 长度, 偏移, 文本)
文本 = 结果[0]
偏移 = 结果[1]
错误 = 结果[2]
else
if true
错误 = "utf8.invalid_lead"
end
end
end
end
end
end
end
if 错误 == ""
return 成功(文本)
else
if true
return 失败(错误, "UTF-8 解码失败")
end
end
utf8编码
params(文本, 内存, 基址)
return 编码(文本, 内存, 基址)
utf8解码
params(内存, 基址, 长度)
return 解码(内存, 基址, 长度)