diff --git a/README.md b/README.md index 207d96a..9219669 100644 --- a/README.md +++ b/README.md @@ -107,7 +107,18 @@ rfx.Set("Name", "Bob") | 50 元素 slice | 594 ns / 6 allocs | 25 ns / 1 alloc | **24x** | | 8 字段纯值 struct | 85.5 ns / 2 allocs | 25.5 ns / 1 alloc | 3.4x | -判断标准就一句:**这份数据我会不会通过 R 去写?写了穿透出去有没有问题?** +**注意这笔开销只发生在 `New` 这一次。** 构造完成后两者的内部表示完全相同, +后续 `Get`/`Set` 走同一条代码路径,速度没有差别: + +| | 构造后 `Get` | 构造后 `Set` | +|---|---|---| +| `New(v)` 传值构造 | 49.7 ns / 2 allocs | 27.2 ns / 0 allocs | +| `New(&v)` 传指针构造 | 50.3 ns / 2 allocs | 27.1 ns / 0 allocs | + +所以要看的是**构造频次**而不是访问频次:构造一次访问很多次的话, +传值那点开销会被摊薄;每个请求都构造、对象又含 map/slice 时才值得计较。 + +至于选哪个,标准就一句:**这份数据我会不会通过 R 去写?写了穿透出去有没有问题?** - 只读,或者本来就想改调用方的数据 → **传指针** - 需要一份互不干扰的副本 → 传值(或者传指针之后用 `Scope()` 取局部副本) diff --git a/docs/flow-new.svg b/docs/flow-new.svg index db4ce13..55b0f97 100644 --- a/docs/flow-new.svg +++ b/docs/flow-new.svg @@ -1,5 +1,5 @@ + aria-label="New 的流程:先按具体类型走快速分支(nil 和 valuex.Nil 返回 Nil、R 原样返回、[]R 直接包装),否则经 normalizeInputValue 解包、递归解引用指针和 interface、校验目标类型,再按 isPtr 分岔:传指针则直接借用,传值则再按类型是否含引用成分分两条:纯值逐字节浅拷贝,含 map/slice/指针才 DeepClone 递归,最后构造 rfx">