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).
43 lines
769 B
Markdown
43 lines
769 B
Markdown
|
||
# @exec random
|
||
## 字节
|
||
|
||
`params(数量)`
|
||
|
||
读取 数量 个 OS 熵字节,返回 List<Int>(每个 0–255)。仅项目模式,
|
||
需要显式 --allow-random;pure/strict 拒绝。
|
||
|
||
`return resource.request("random.bytes", [数量])`
|
||
|
||
## 整数
|
||
|
||
`params(上限)`
|
||
|
||
返回 0 <= 值 < 上限 的整数。上限 必须大于 0;使用 8 个熵字节
|
||
组合后取模(无偏拒绝采样尚未实现)。
|
||
|
||
`if 上限 <= 0`
|
||
|
||
`return {ok: false, code: "random.invalid", message: "上限必须大于 0"}`
|
||
|
||
`end`
|
||
**字节结果 = 字节(8)**
|
||
|
||
`if not 字节结果.ok`
|
||
|
||
`return 字节结果`
|
||
|
||
`end`
|
||
**值 = 0**
|
||
|
||
**下标 = 0**
|
||
|
||
`while 下标 < 8`
|
||
|
||
**值 = 值 * 256 + 字节结果.value[下标]**
|
||
|
||
**下标 = 下标 + 1**
|
||
|
||
`end`
|
||
`return {ok: true, value: 值 % 上限}`
|