项目值
名称NEXT-LOCAL-ID(规格文档 BIND NEXT-LOCAL-ID)
TAG ID0x1DDL
Codec ID0x00001DD0
规格文档0x00000000/codecs/0x00001DD0/(DECLARE 对象 1DD0)
章节14 1110(Meta),章节内偏移 C = 29
KindMeta · 类:谱系
TAG WORD0001 1101 1101 LLLL(000K KKKC CCCC LLLL)
索引说明下一个要分配的 LOCAL ID(auto increment)。放在版本列表 versions.geul 的 HEAD 中
Hugo 侧meta/lineage/next-local-id.md

字段(规格文档)

FIELD 在文档中的顺序就是 Payload 字段的顺序(Codec 规格文档)。

顺序字段(BIND)FIELD宽度接收格式(CODEC)ENUM
1next#2剩余原始值(0xFFFF)

记录该文档的下一版本要分配给新陈述的 LOCAL ID(DBMS 的 auto increment、MySQL AUTO_INCREMENT)。文档在任何版本中已分配的 LOCAL ID 都小于该值。

布局

TAG WORD          0001 1101 1101 LLLL      Codec 0x1DDL
Payload           下一个要分配的 LOCAL ID,最短宽度的 unsigned 整数
  • Codec:Meta 0x1DDL,谱系类
  • Payload:原始值(最短宽度的 unsigned 整数)
  • 数量:至多一个
  • 放置位置:版本列表文档 versions.geul 的 HEAD(PUBLICATION)

解释与有效性

  • LOCAL ID(含 Edge Id)是跨越版本的身份(修订)。新陈述取得该值,该值加 1。已删除的 LOCAL ID 不再使用。因此即使拥有最大值的陈述被删除,该值也不会减小。
  • LOCAL ID 0 不分配,因此初始值为 1。尚无版本时不放置该 Meta,下一个编号为 1。
  • 公布方公布版本时,在新的列表文档中更新记录。必须大于所公布版本中用到的任何 LOCAL ID。小于或等于则为 invalid。
  • 该值只增不减。小于上一个列表文档(PARENT)的值则为 invalid。
  • 不做版本管理的文档(没有 versions.geul 的文档、无名文档)中没有它。这类文档也不设 diff(DELTA-BASE)。
  • 不放在文档正文(版本文档)中。编号的记忆不是文档内容,而是延续撰写文档的公布方的状态(相当于 git 的 refs,而非提交)。

示例

下一个分配编号 524:

1DD1 020C
  • TAG 1DD1(Meta 0x1DDL,LLLL=0001,2 WORD),Payload 020C。

规格文档原文

这是用 geul show 读取规格文档 0x00000000/codecs/0x00001DD0/latest.geul 的结果(十六进制为大写)。

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DD000000000
BODY
#1 DECLARE 0x1DD0
#2 FIELD #1 rest
#3 BIND #1 "NEXT-LOCAL-ID"
#4 BIND #2 "next"