Files
marqdo-cli/tests/conformance/semantics/58-memory-hash-table.mq.md
T
cflmy 92bfbf2568 feat(rfc-cm): baseline P0-P3 compute machine, stdlib and resource slices
Implements the first vertical slices of RFC-CM-0001/0002 on top of a113d89:

- P1: opaque Memory regions (64 KiB pages, budgets, grow-only), byte
  read/write, Memory-index place assignment, wire/host-boundary rejection.
- CM-A04/A05: value-semantics List/Map/Text/Table primitives and the
  recoverable Result map convention.
- CM-A06: opaque Resource handles, resource.open/read/write/close, stdout
  write, granted project-file read and buffered write, strict fail-closed.
- CM-A07 Compat-A: explicit .mq.md format/utf8/io chain matching builtin
  print for the covered value types; builtin remains default.
- P2 fixtures: allocators, list/tree/graph/hash, integer codecs, UTF-8
  encode/decode, CSV/JSON subsets, table filter/sort/join, bytecode VM.
- ADRs 0022-0027, spec updates, evidence reports and 68 semantic goldens.

Gate: cargo fmt --check, clippy -D warnings, 407 tests passed.
2026-11-20 21:16:54 +08:00

2.5 KiB

写32

(内存, 基址, 值)

字节3 = 值 % 256

字节2 = 值 // 256 % 256

字节1 = 值 // 65536 % 256

字节0 = 值 // 16777216 % 256

内存[基址] = 字节0

内存[基址 + 1] = 字节1

内存[基址 + 2] = 字节2

内存[基址 + 3] = 字节3

None

读32

(内存, 基址)

内存[基址] * 16777216 + 内存[基址 + 1] * 65536 + 内存[基址 + 2] * 256 + 内存[基址 + 3]

成功

(值)

{ok: true, value: 值}

失败

(代码, 消息)

{ok: false, code: 代码, message: 消息}

初始化

(内存, 容量)

头部 8 字节:0..3 是元素数,4..7 是槽数。槽从偏移 8 开始,每槽 8 字节: 键 u32 + 值 u32。键 0 表示空槽,因此业务键必须从 1 开始。

写32(内存, 0, 0)

写32(内存, 4, 容量)

成功(None)

插入

(内存, 键, 值)

线性探测;键已存在时只更新值,不增加元素数。

容量 = 读32(内存, 4)

位置 = 键 % 容量

尝试 = 0

完成 = false

  • 尝试 < 容量 and not 完成

    槽 = 8 + (位置 + 尝试) % 容量 * 8

    槽键 = 读32(内存, 槽)

    1. 槽键 == 0

      写32(内存, 槽, 键)

      写32(内存, 槽 + 4, 值)

      写32(内存, 0, 读32(内存, 0) + 1)

      完成 = true

    2. 槽键 == 键

      写32(内存, 槽 + 4, 值)

      完成 = true

    3. true

      尝试 = 尝试 + 1

  1. 完成

    成功(None)

  2. true

    失败("hash.full", "哈希表已满")

查找

(内存, 键)

遇到空槽即停止;找不到返回 None。

容量 = 读32(内存, 4)

位置 = 键 % 容量

尝试 = 0

结果 = None

  • 尝试 < 容量

    槽 = 8 + (位置 + 尝试) % 容量 * 8

    槽键 = 读32(内存, 槽)

    1. 槽键 == 键

      结果 = 读32(内存, 槽 + 4)

      尝试 = 容量

    2. 槽键 == 0

      尝试 = 容量

    3. true

      尝试 = 尝试 + 1

结果

main

业务键从 1 开始。37 与 5 在 32 个槽中同余,用来验证线性探测。

内存 = memory.new(1, 1)

初始化(内存, 32)

插入5 = 插入(内存, 5, 50)

插入(内存, 37, 370)

插入(内存, 12, 120)

插入(内存, 5, 55)

内存2 = memory.new(1, 1)

初始化(内存2, 2)

插入(内存2, 1, 10)

插入(内存2, 2, 20)

表满 = 插入(内存2, 4, 40)

[插入5, 查找(内存, 5), 查找(内存, 37), 查找(内存, 12), 查找(内存, 99), 读32(内存, 0), 表满, 查找(内存2, 1), 查找(内存2, 2)]