ItemValue
NameBIND (specification document BIND BIND)
TAG ID0x0A3L
Codec ID0x00000A30
Specification document0x00000000/codecs/0x00000A30/ (DECLARE target 0A30)
Section5 0101 (Edge statement), offset within section C = 3
KindEdge · family: statement, group: pointing and names
TAG WORD0000 1010 0011 LLLL (000K KKKC CCCC LLLL)
Index descriptionBinds to Subject a name (UTF8-TEXT-*) that machines match against. It must be unique within its scope and match exactly, and has no language
Hugo sideedge/bind.md

Fields (specification document)

The order of FIELDs in the document is the order of the Payload fields (Codec specification document). The Edge Id of an Edge is not declared as a FIELD.

OrderField (BIND)FIELDWidthAccepted form (CODEC)ENUM
1subject#2recordAny record (excluding slot markers)
2name#3record0720 UTF8-TEXT-EVEN, 0730 UTF8-TEXT-ODD

BIND is a statement Edge that binds to Subject a name that machines match against. Codec 0x0A3L.

It is naming. The human-readable name (a per-language title) is the job of LABEL. The name of a program symbol and the domain name in the Issuer list are written with the same record.

Layout

TAG WORD          0000 1010 0011 LLLL
[Length extension TAG]
Edge Id           LOCAL Reference record
Subject           1 Reference record, or 1 codec TAG WORD
Name              1 UTF8-TEXT-* Value

Interpretation and validity

  • Subject is exactly one complete Reference record. If LOCAL, it is a target in this document (a symbol, etc.); if a pointing Reference, it is a target in another document. The document itself is DOC-POINTER, and the Issuer itself is ISSUER-POINTER.
  • Alternatively, Subject is a single codec TAG WORD (Kind and Codec only, LLLL = 0, no Payload). This is not a record with an empty Payload; it points to that direct code itself, that is, to its specification document (GEUL Issuer codec 0x0000<TAG>) (Codec specification document, DECLARE). Example: 0B80 is PUBLICATION. An Issuer-form codec is not pointed to in this form.
  • No other record (a Value, etc.) can be Subject. The FIELD in the BIND specification document declares Subject only as width 0 (record), so this constraint is a rule of the BIND body.
  • The name is exactly one UTF8-TEXT Value. It has no language and is not normalized. Names are the same only if their bytes are the same.
  • The scope of a name is the document containing the BIND. Within one document, the same name is not bound to different Subjects.
  • Several names may be bound to one Subject (aliases, former names). Unless the document says otherwise, the last BIND is the representative name.
  • Other records point to a target by LOCAL ID, not by name. Names are used to match the outside (host functions, address input, people).
  • The characters usable in a name are set by its use. A domain name in the Issuer list follows domain rules (lowercase, IDNA) (publication addresses and version list).
  • A version list does not hold BIND. There is no document-name address (publication addresses and version list).

Length

total = 1 + N_len + N_id + N_subject + N_name WORD

Example (non-normative)

Program symbol: Edge Id 0003, Subject LOCAL 7, name main.

  • The name main is 4 bytes (even), so 0722 6D61 696E is 3 WORDs.
  • The Edge is TAG 1 + Edge Id 2 + Subject 2 + name 3 = 8 WORDs, TAG 0A37.
0A37 0051 0003 0051 0007 0722 6D61 696E

Related pages

Specification document source

This is the specification document 0x00000000/codecs/0x00000A30/latest.geul as read with geul show (hexadecimal in uppercase).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000A3000000000
BODY
#1 DECLARE 0x0A30
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "BIND"
#5 BIND #2 "subject"
#6 BIND #3 "name"
#7 CODEC #3 0x0720
#8 CODEC #3 0x0730