ElementoValor
NombreNEXT-LOCAL-ID (BIND del documento de especificación NEXT-LOCAL-ID)
TAG ID0x1DDL
Codec ID0x00001DD0
Documento de especificación0x00000000/codecs/0x00001DD0/ (destino de DECLARE 1DD0)
Sección14 1110 (Meta), desplazamiento C dentro de la sección = 29
KindMeta · clase: linaje
TAG WORD0001 1101 1101 LLLL (000K KKKC CCCC LLLL)
Descripción del índicePróximo LOCAL ID a asignar (auto increment). Se pone en el HEAD de la lista de versiones versions.geul
Lado Hugometa/lineage/next-local-id.md

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato receptor (CODEC)ENUM
1next#2valor en bruto restante (0xFFFF)

Indica el LOCAL ID que la versión siguiente del documento asignará a un nuevo enunciado (el auto increment de un DBMS, AUTO_INCREMENT de MySQL). Todos los LOCAL ID asignados en cualquier versión del documento son menores que este valor.

Layout

TAG WORD          0001 1101 1101 LLLL      Codec 0x1DDL
Payload           próximo LOCAL ID a asignar, entero unsigned del ancho más corto
  • Codec: Meta 0x1DDL, clase de linaje
  • Payload: valor en bruto (entero unsigned del ancho más corto)
  • Cantidad: como máximo uno
  • Dónde se pone: en el HEAD del documento de la lista de versiones versions.geul (PUBLICATION)

Interpretación y validez

  • El LOCAL ID (incluido el Edge Id) es una identidad que trasciende las versiones (revisión). Un nuevo enunciado recibe este valor y el valor aumenta en 1. Un LOCAL ID eliminado no se reutiliza. Por eso, aunque se elimine el enunciado de valor máximo, este valor no disminuye.
  • El LOCAL ID 0 no se asigna, así que el primer valor es 1. Si aún no hay versiones, no se pone este Meta y el siguiente número es 1.
  • Quien publica lo actualiza en el nuevo documento de lista al publicar una versión. Debe ser mayor que cualquier LOCAL ID usado en las versiones publicadas. Si es menor o igual, es invalid.
  • El valor solo crece. Si es menor que el del documento de lista anterior (PARENT), es invalid.
  • No existe en documentos sin control de versiones (documentos sin versions.geul, documentos sin nombre). Esos documentos tampoco llevan diff (DELTA-BASE).
  • No se pone en el cuerpo del documento (el documento de versión). Recordar el número no es contenido del documento sino estado de quien publica y continúa el documento (en git, no el commit sino el lado de refs).

Ejemplo

Próximo número a asignar 524:

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

Texto original del documento de especificación

Es el documento de especificación 0x00000000/codecs/0x00001DD0/latest.geul leído con geul show (hexadecimal en mayúsculas).

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