URI-RELATIVE-REF is a Value that holds an ASCII byte sequence of the RFC 3986 relative-ref grammar. The base URI and the resolved result are not put in the Payload.
Layout
- Code: Value
VALUE-ISSUER-2WORD(0x09DL), Issuer0x00000007IETF, codec number0x00008000(even number of bytes) or0x00008001(odd number of bytes). Family TEXT. - The number of bytes is determined by the least significant bit of the codec number and the number of Payload WORD. It is
2 × number of Payload WORD − least significant bit, and there is no Byte Count (Value).
TAG WORD 0000 1001 1101 LLLL Codec 0x09DL
[Length ext. TAG] when the total is 15 WORD or more
Issuer 2 WORD 0x00000007 (IETF)
Codec number 2 WORD 0x00008000/0x00008001
Payload WORD 1st ... Nth relative-ref bytes / final zero padding
Interpretation and validity
- The byte sequence must conform to the RFC 3986 grammar
relative-ref = relative-part [ "?" query ] [ "#" fragment ]. - The terminals of the URI grammar are US-ASCII characters. Allowed ASCII characters are stored as is, and when an octet is percent-encoded, the form
pct-encoded = "%" HEXDIG HEXDIGis used. Non-ASCII characters must not be put in directly as literal bytes. - Since
relative-partcan bepath-empty, an empty byte sequence is also a grammatically validrelative-ref. - The base URI, the resolution context, and the resolved result are context outside this format.
- Within a WORD, the upper byte comes first. If the number of bytes is odd (odd code), the unused lower byte of the last WORD must be
00. - The number of Payload WORD is
ceil(number of bytes / 2). If the code is odd and the lower byte of the last WORD is not00, it is rejected.
Standards basis
- The
relative-ref, URI character, and percent-encoding grammar follow RFC 3986, Uniform Resource Identifier (URI): Generic Syntax. - The even/odd code pair, the zero padding, and the placement in GEUL TAG/Length and 16-bit WORD are framing rules of this format. The base URI and the result of reference resolution are context of the RFC but are not put in the Payload.
Length
- The total is the number of WORD obtained by adding TAG 1 WORD, the Length extension TAG (if present), Issuer 2 WORD, codec number 2 WORD, and the Payload. 14 WORD or fewer use the direct length, and 15 WORD or more use the
1110or1111extended length, and the extension TAG is included in the total (Length). - Zero bytes are semantically allowed as an empty
relative-refand have no Payload WORD. Its physical placement is an open problem below.
Example
a/b?x=1is 7 bytes (odd), so the codec number is0x00008001and the Payload is612F 623F 783D 3100. The total is 9 WORD, soLLLL=1000. The whole record is09D8 0000 0007 0000 8001 612F 623F 783D 3100.
Open problems
- The physical placement of an empty
relative-ref(0 bytes). A record without a Payload does not fit the rule “Payload of at least 1 WORD”, so it has not yet been decided.