CBOR

1.1. 目標群

~CBORの目標群は、 概ね重要度の高いものから順に： ◎ The objectives of CBOR, roughly in decreasing order of importance, are:

1. 表現は、 各種~Internet標準にて利用される ほとんどの共通な~data形式を， 一義的に符号化-可能でなければならない： ◎ The representation must be able to unambiguously encode most common data formats used in Internet standards.

   • それは、 ~binary符号化法を利用して，一群の基本的な［ ~data型, 構造 ］として適度なものを表現しなければならない。 ここでの “適度” とは，~JSONの能力に大きく波及されることをいうが、 主要な追加として~binary`~byte~string$を伴う。 ~supportする構造は、［ `~array$, ~tree ］に制限され，［ `loop^en, `lattice-style graph^en 【言い換えれば、一般な~graph構造】 ］は~supportしない。 ◎ It must represent a reasonable set of basic data types and structures using binary encoding. "Reasonable" here is largely influenced by the capabilities of JSON, with the major addition of binary byte strings. The structures supported are limited to arrays and trees; loops and lattice-style graphs are not supported.
   • すべての~data形式を一意に符号化する要件は無い — すなわち、［ “7” などの~numberが複数の異なる仕方で符号化され得る ］ことも受容-可能である。 ◎ There is no requirement that all data formats be uniquely encoded; that is, it is acceptable that the number "7" might be encoded in multiple different ways.

2. ［ ~memory, 処理能力, 命令~集合 ］が ごく制限された~systemを~supportするため、［ 符号化器／復号器 ］用の~codeは，~compact†になることが可能でなければならない。 ◎ The code for an encoder or decoder must be able to be compact in order to support systems with very limited memory, processor power, and instruction sets.

   • ［ 符号化器, 復号器 ］は、 ごく小さな~code量で実装-可能になる必要がある （例えば、 `RFC7228$r にて定義される `class 1^en に拘束された~node）。 ◎ An encoder and a decoder need to be implementable in a very small amount of code (for example, in class 1 constrained nodes as defined in [RFC7228]).
   • ~CBOR形式は、 現今の［ ~dataの計算機-表現 ］を利用するべきである （例えば、 ~binaryから~decimalへの変換は要求しない）。 ◎ The format should use contemporary machine representations of data (for example, not requiring binary-to-decimal conversion).

   【† `compact^en — “密” ／ “ぎゅうぎゅう詰め” 。 ~CBOR の `Concise^en （ “簡潔” ）と混同しないように。 】

3. ~dataは、 ~schema記述を伴うことなく，復号-可能でなければならない ⇒ ~JSONと類似に、 符号化された~dataは，［ 汎用な復号器を書けるよう，自己を記述している ］べきである。 ◎ Data must be able to be decoded without a schema description. • Similar to JSON, encoded data should be self-describing so that a generic decoder can be written.
4. 直列化は、 適度に~compactにならなければならないが、 ~dataの~compactさより，［ 符号化器, 復号器 ］用の~codeの~compactさが優先される。 ここでの “適度” とは、 ~JSONにより~sizeにおける上限として束縛され， 実装の複階性により束縛されることをいう — それは、 ~compactさを達成するためにかける労を制限するものになり得る。 一般的な圧縮~schemeを利用したり，~bit列を弄り回すことは、 複階性を抑える目標に違反する。 ◎ The serialization must be reasonably compact, but data compactness is secondary to code compactness for the encoder and decoder. ◎ "Reasonable" here is bounded by JSON as an upper bound in size and by the implementation complexity, which limits the amount of effort that can go into achieving that compactness. Using either general compression schemes or extensive bit-fiddling violates the complexity goals.
5. ~CBOR形式は、［ 拘束された~node, 大容量な応用 ］どちらにも適用-可能でなければならない。 このことは、［ 符号化, 復号 ］どちらにおいても［ ~CPU利用度において適度に安上がりでなければならない ］ことを意味する。 これは、［ 拘束された~node ］にも［ 応用における大容量な~dataを伴う可能性もある用法 ］にも関連する。 ◎ The format must be applicable to both constrained nodes and high-volume applications. ◎ This means it must be reasonably frugal in CPU usage for both encoding and decoding. This is relevant both for constrained nodes and for potential usage in applications with a very high volume of data.

6. ~CBOR形式は、 ~JSONとの相互~変換~用に，すべての~JSON~data型を~supportしなければならない — それは： ◎ The format must support all JSON data types for conversion to and from JSON.

   • ~JSONの能力の中で表現される~dataに関する限り， 適度な~levelの変換を~supportしなければならない。 ◎ It must support a reasonable level of conversion as long as the data represented is within the capabilities of JSON.＼
   • すべての型の~dataに対し，［ ~JSONへの単方向な対応付けを定義する ］ことがアリでなければならない。 ◎ It must be possible to define a unidirectional mapping towards JSON for all types of data.

7. ~CBOR形式は、 拡張-可能かつ［ 拡張された~dataは、 これまでの復号器により復号-可能 ］でなければならない。 ~CBOR形式は： ◎ The format must be extensible, and the extended data must be decodable by earlier decoders.

   • 数十年の利用-用に設計される。 ◎ The format is designed for decades of use.
   • ある形を成す拡張能 — 拡張を解さない復号器でも~messageを復号できるよう，~fallbackを許容する拡張能 — を~supportしなければならない。 ◎ The format must support a form of extensibility that allows fallback so that a decoder that does not understand an extension can still decode the message.
   • 後の~IETF標準により，将来に拡張-可能でなければならない。 ◎ The format must be able to be extended in the future by later IETF standards.

1.2. 各種用語

この文書~内の~keyword "MUST" … 【以下、この段落の内容は`~IETF日本語訳 共通~page＠~IETFcommon#requirements-notation$に移譲。】 ◎ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

“~octet” の同義語として，今や~~慣例になった用語 “~byte” が利用される。 すべての複-~byte値は、 ~network~byte順序（ “`big-endian^en” としても知られる）で符号化される （すなわち，最も有意な~byteが最初）。 ◎ The term "byte" is used in its now-customary sense as a synonym for "octet". All multi-byte values are encoded in network byte order (that is, most significant byte first, also known as "big-endian").

この仕様は、 次に挙げる各種用語を用立てる： ◎ This specification makes use of the following terminology:

`~data~item@ （ `data item^en, 略して~item） ◎ Data item:

~CBOR~dataを成す 1 個として数えられるモノ。 ~data~itemの構造は、［ 入子にされた 0 個以上の~data~item ］を包含することもある。 この用語は、［ 表現~形式における~data~item, 復号器により~data~itemから導出し得る抽象-~levelの~data ］どちらにも利用される — 前者を特定的に指すときは、 用語 `符号化された~data~item@ も利用される。 ◎ A single piece of CBOR data. The structure of a data item may contain zero, one, or more nested data items. The term is used both for the data item in representation format and for the abstract idea that can be derived from that by a decoder; the former can be addressed specifically by using the term "encoded data item".

`復号器@ （ `decoder^en ） ◎ Decoder:

`整形式$な`符号化された~data~item$を復号して，結果を応用に可用にする処理n【を行うもの】。 正式には、［ ~CBORの構文~規則を利用して入力を【一群の “~token” に】分断しておく，構文解析器 ］および［ 当の~dataを応用に相応しい形に準備する，意味論上の処理器 ］を包含する復号器。 ◎ A process that decodes a well-formed encoded CBOR data item and makes it available to an application. Formally speaking, a decoder contains a parser to break up the input using the syntax rules of CBOR, as well as a semantic processor to prepare the data in a form suitable to the application.

`符号化器@ （ `encoder^en ） ◎ Encoder:

応用~情報から［ （`整形式$な）表現~形式を成す`~data~item$ ］を生成する処理n【を行うもの】。 ◎ A process that generates the (well-formed) representation format of a CBOR data item from application information.

`~data~stream@ （ `data stream^en ） ◎ Data Stream:

0 個以上の［ 他の~data~itemの中に入子にされない（ “~top-levelの” ）~data~item ］たちが成す連列 （応用~例は `RFC8742$r を見よ）。 ◎ A sequence of zero or more data items, not further assembled into a larger containing data item (see [RFC8742] for one application). The independent data items that make up a data stream are sometimes also referred to as "top-level data items".

`整形式@ （ `well-formed^en, “きちんと形成された” ）： ◎ Well-formed:

~CBORの構文-構造に従う~data~item 【したがって、 “整形式” という語は，当の~data~itemは`符号化された~data~item$であることを含意する】 。 整形式な~data~itemは、 `~head$, および［ ~CBORにて定義されるとおり，その値により含意される［ `~byte~string$群／~data~item群 ］］を利用し，後続している余計な~dataは含まない。 ◎ A data item that follows the syntactic structure of CBOR. A well-formed data item uses the initial bytes and the byte strings and/or data items that are implied by their values as defined in CBOR and does not include following extraneous data.＼

~CBOR復号器が返すものは、 定義により，`整形式$な~data~itemから得られた内容に限られる。 ◎ CBOR decoders by definition only return contents from well-formed data items.

`妥当@ （ `valid^en ） ◎ Valid:

`整形式$な~data~itemのうち， `~data~item$に適用される意味論上の制約にも従うもの （ `5.3§ ）。 ◎ A data item that is well-formed and also follows the semantic restrictions that apply to CBOR data items (Section 5.3).

`期待され@ る （ `expected^en ） ◎ Expected:

用語 “期待される” は、 英語における その通常の意味は別として，［ 応用が自身への入力~dataに対し課す要件 ］のうち［ ~CBOR妥当性を超えるもの ］を述べるために利用される。 ◎ Besides its normal English meaning, the term "expected" is used to describe requirements beyond CBOR validity that an application has on its input data.＼

［ `整形式$（処理-可能）, `妥当$（妥当性を検査する汎用な復号器により検査-済み）, `期待され$る（当の応用により検査-済み） ］は、 これらの受容-能が成す層が成す階層を形成する。 【言い換えれば、`期待され$るもの ならば必然的に`妥当$であり，`妥当$ならば必然的に`整形式$である。】 ◎ Well-formed (processable at all), valid (checked by a validity-checking generic decoder), and expected (checked by the application) form a hierarchy of layers of acceptability.

`~stream復号器@ （ `stream decoder^en ） ◎ Stream decoder:

ある`~data~stream$を復号して、 当の連列を成す各~data~itemを受信するに伴い，それを応用に可用にする処理n【を行うもの】。 【この用語は、この仕様では利用されていない。】 ◎ A process that decodes a data stream and makes each of the data items in the sequence available to an application as they are received.

`~float$用の用語と概念 — ~Infinity, ~NaN（ `not a number^en ）, 負な 0, ~subnormal†など — は、 `IEEE754$r にて定義される。 ◎ Terms and concepts for floating-point values such as Infinity, NaN (not a number), negative zero, and subnormal are defined in [IEEE754].

【† 仮数が 1 以上になるよう正規化し得ないほど 0 に近い~number （`参考＠https://en.wikipedia.org/wiki/Subnormal_number$） 】

この文書は、［ ~bit算術／~data型 ］を説明する所では， ~programming言語 C `C$r に馴染みな記法を利用することに加え、 次に挙げる表記も利用する： ◎ Where bit arithmetic or data types are explained, this document uses the notation familiar from the programming language C [C], except that＼

• { %A 〜 %B } は、 %A 以上 %B 以下の範囲を表記する。 【原文では、 %A..%B と表記される。】 ◎ ".." denotes a range that includes both ends given,＼
• %A^%B （ %B は上付文字）は、 指数~化を表記する — 例： 2`64^sup は、 2 の 64 乗を表す。 ◎ and superscript notation denotes exponentiation. For example, 2 to the power of 64 is notated: 264.＼

この仕様の素な~text~versionでは… 【以下，省略する（この訳には不要な表記規約なので）】。 ◎ In the plain-text version of this specification, superscript notation is not available and therefore is rendered by a surrogate notation. That notation is not optimized for this RFC; it is unfortunately ambiguous with C's exclusive-or (which is only used in the appendices, which in turn do not use exponentiation) and requires circumspection from the reader of the plain-text version.

各~例と疑似-~codeは、［ 有符号な~integerには， 2 の補数による表現を利用する／ 有符号な~integerの右~shiftは，正負符号~拡張を遂行する 【すなわち、負な場合は，最上位~bitに 1 を補充する】 ］と見做す — これらの前提は、 C++ の 2020年~version （現時点では最終-草案 `Cplusplus20$r として可用）の［ § 6.8.1 `basic.fundamental^en, § 7.6.7 `expr.shift^en ］にも指定される。 ◎ Examples and pseudocode assume that signed integers use two's complement representation and that right shifts of signed integers perform sign extension; these assumptions are also specified in Sections 6.8.1 (basic.fundamental) and 7.6.7 (expr.shift) of the 2020 version of C++ (currently available as a final draft, [Cplusplus20]).

~hexadecimal~number用の "0x" 記法と類似に、 ~binary記法による~numberには "0b" が接頭される。 そのような~numberには、 もっぱら可読性を得るためとして，~underscoreが追加され得る。 なので， `00100001^B ( `21^X ）は、［ 当の~byteを成す~bit群に欲される解釈を強勢する ］よう， `001_00001^B と書かれることもある — この事例では、 3 個の~bitと 5 個の~bitに分割される。 符号化された各`~data~item$は、［ "0x" ／ "0b" ］記法で与えられることもある — これらの値は、 まず，~C言語と同じく~numberとして解釈してから， ~network~byte順序による`~byte~string$として — 当の記法~内に表出された頭部を成す 0 ~byte列を含めて — 解釈される。 ◎ Similar to the "0x" notation for hexadecimal numbers, numbers in binary notation are prefixed with "0b". Underscores can be added to a number solely for readability, so 0b00100001 (0x21) might be written 0b001_00001 to emphasize the desired interpretation of the bits in the byte; in this case, it is split into three bits and five bits. Encoded CBOR data items are sometimes given in the "0x" or "0b" notation; these values are first interpreted as numbers as in C and are then interpreted as byte strings in network byte order, including any leading zero bytes expressed in the notation.

この仕様の素な~text~versionでは，単語を強勢する所では… 【以下，省略する（この訳には不要な表記規約なので）。】 ◎ Words may be italicized for emphasis; in the plain text form of this specification, this is indicated by surrounding words with underscore characters. Verbatim text (e.g., names from a programming language) may be set in monospace type; in plain text, this is approximated somewhat ambiguously by surrounding the text in double quotes (which also retain their usual meaning).

2.1. 拡張された汎用~data~model

この基本的な`汎用~data~model$は、 この文書において，いくつかの［ `単純~値$, `~tag番号$ ］の登録により拡張される — 次に挙げるものなど： ◎ This basic generic data model has been extended in this document by the registration of a number of simple values and tag numbers, such as:

• `false$i, `true$i, `null$i, `undefined$i （挙げられた順に，【`引数$】［ 20, 21, 22, 23 ］により識別される`単純~値$【！`3.3§】） ◎ false, true, null, and undefined (simple values identified by 20..23, Section 3.3)
• より大きい［ 範囲, 精度 ］を伴う［ `~integer$値, `~float$値 ］（`~tag番号$ ~IN { `2$tag 〜 `5$tag } ） ◎ integer and floating-point values with a larger range and precision than the above (tag numbers 2 to 5, Section 3.4)
• 応用~data型 — ~RFC 3339 にて定義される日時~stringなど （`~tag番号$ ~IN { `1$tag, `0$tag } ） ◎ application data types such as a point in time or date/time string defined in RFC 3339 (tag numbers 1 and 0, Section 3.4)

`拡張された汎用~data~model$を成す追加的な要素は、 ~CBOR用に作成された~IANA~registryを介して，定義できる （または，定義-済みである）。 ある汎用な［ 符号化器／復号器 ］において，そのような拡張が未知であっても、 その拡張を利用している~data~itemは，［ 基本的な`汎用~data~model$の中で — すなわち，汎用な［ `単純~値$／`~tag$ ］（順不同）として — 当の応用~interfaceで表現する ］ことにより，当の応用［ から／へ ］渡せる。 ◎ Additional elements of the extended generic data model can be (and have been) defined via the IANA registries created for CBOR. Even if such an extension is unknown to a generic encoder or decoder, data items using that extension can be passed to or from the application by representing them at the application interface within the basic generic data model, i.e., as generic simple values or generic tags.

言い換えれば、 基本的な`汎用~data~model$は， この文書にて定義されるとおり安定的である一方で、 `拡張された汎用~data~model$は，新たな［ `単純~値$／`~tag番号$ ］の登録により拡げられるが，狭められることは決してない。 ◎ In other words, the basic generic data model is stable as defined in this document, while the extended generic data model expands by the registration of new simple values or tag numbers, but never shrinks.

汎用な［ 符号化器／復号器 ］は，［ `false$i, `true$i, `null$i ］（ `undefined$i は意図的に~~除外される【！omitted】）を［ 各自の~programming環境に適切な形 ］で表現できることが強く期待されるが、［ 各種`~tag$により作成される~data~model拡張 ］の実装は，真に任意選択~であり, 実装~品質に関する事である。 ◎ While there is a strong expectation that generic encoders and decoders can represent false, true, and null (undefined is intentionally omitted) in the form appropriate for their programming environment, the implementation of the data model extensions created by tags is truly optional and a matter of implementation quality.

2.2. ~protocolに特有な~data~model

ある~CBORに基づく~protocol用に特有な~data~modelは、 通例的に［ `拡張された汎用~data~model$を成す，ある下位集合 ］を採って，［ この下位集合, それを成す各~成分 ］の中の~data~itemに応用の意味論をアテガう。 そのような［ 応用に特有な~data~modelを文書化するとき／ 各種~data~itemの型を指定するとき ］は、 当の型は［ `汎用~data~model$における，その名前 ］（例： “負な~integer” ／ “~array” ） により識別する方が好ましい — その~CBOR表現の側面（例： “`~major型$ `1$mj” ／ “~major型 `4$mj” ）で参照rする代わりに。 ◎ The specific data model for a CBOR-based protocol usually takes a subset of the extended generic data model and assigns application semantics to the data items within this subset and its components. When documenting such specific data models and specifying the types of data items, it is preferable to identify the types by their generic data model names ("negative integer", "array") instead of referring to aspects of their CBOR representation ("major type 1", "major type 4").

特有な~data~modelは、［ `~map~key$と符号化器 ］に自由度を与える目的で， 値の等価性を（型が異なる値どうしも含めて）指定することもできる。 例えば，`汎用~data~model$においては、 `妥当$な`~map$は，`~key$として［ 0, 0.0 ］どちらを有してもヨイ【異なるものとして扱われる】ので， 符号化器は 0.0 を`~integer$（`~major型$ `0$mj 【！`3.1§】）として符号化してはナラナイ。 しかしながら，特有な~data~modelが［ ~integerとして等しい［ `~float$, `~integer$ ］表現は等価である ］ものと宣言する場合、 同じ`~map$内で［ 0, 0.0 ］両者を`~map~key$に利用することは — 異なる`~major型$として符号化されようが — 重複と見なされ，`妥当$でなくなることに加え、 符号化器は，［ ある~integerに等しい値をとる`~float$を — たぶん，符号化される~byte数を節約するために — `~integer$として符号化する ］ことも［ その逆を行う ］こともできる。 ◎ Specific data models can also specify value equivalency (including values of different types) for the purposes of map keys and encoder freedom. For example, in the generic data model, a valid map MAY have both 0 and 0.0 as keys, and an encoder MUST NOT encode 0.0 as an integer (major type 0, Section 3.1). However, if a specific data model declares that floating-point and integer representations of integral values are equivalent, using both map keys 0 and 0.0 in a single map would be considered duplicates, even while encoded as different major types, and so invalid; and an encoder could encode integral-valued floats as integers or vice versa, perhaps to save encoded bytes.

3.1. 各種~major型

各種［ `~major型$, `追加l情報$ ］および［ 当の型に結付けられる他の~byte列 ］を以下に挙げる： ◎ The following lists the major types and the additional information and other bytes associated with the type.

`~major型$ `0@mj ◎ Major type 0:

無符号`~integer$ ~IN 範囲 { 0 〜 2`64^sup ~MINUS 1 } 。 ◎ An unsigned integer in the range 0..264-1 inclusive.＼

当の符号化された~itemの値は、`引数$自身になる。 例えば： ◎ The value of the encoded item is the argument itself. For example,＼

• `~integer$ 10 は、 1 個の~byte `000_01010^B （`~major型$ `0$mj, `追加l情報$ `10^ai ） として表記される。 ◎ the integer 10 is denoted as the one byte 0b000_01010 (major type 0, additional information 10).＼
• `~integer$ 500 は、 `000_11001^B （`~major型$ `0$mj, `追加l情報$ `25^ai ）に 【`引数$を成す】 2 個の~byte `01f4^X （~decimalで 500 ）が後続する。 ◎ The integer 500 would be 0b000_11001 (major type 0, additional information 25) followed by the two bytes 0x01f4, which is 500 in decimal.

`~major型$ `1@mj ◎ Major type 1:

負な`~integer$ ~IN 範囲 { −2`64^sup 〜 −1 } 。 ◎ A negative integer in the range -264..-1 inclusive.＼

当の~itemの値は、 ( −1 ~MINUS `引数$ ) になる。 例えば ⇒ `~integer$ −500 は、 `001_11001^B （`~major型$ `1$mj, `追加l情報$ `25^ai ）に 【`引数$を成す】 2 個の~byte `01f3^X （~decimalで 499 ）が後続する。 ◎ The value of the item is -1 minus the argument.＼ For example, the integer -500 would be 0b001_11001 (major type 1, additional information 25) followed by the two bytes 0x01f3, which is 499 in decimal.

`~major型$ `2@mj ◎ Major type 2:

`~byte~string$。 当の~string内の~byte数は`引数$に等しい。 例えば： ◎ A byte string. The number of bytes in the string is equal to the argument. For example,＼

• 長さ 5 の`~byte~string$は、 `先頭~byte$ `010_00101^B （`~major型$ `2$mj, `追加l情報$ `5^ai （長さ用））に［ ~binary内容を成す 5 個の~byte ］が後続する。 ◎ a byte string whose length is 5 would have an initial byte of 0b010_00101 (major type 2, additional information 5 for the length), followed by 5 bytes of binary content.＼
• 長さ 500 の`~byte~string$は、 `先頭~byte$ `010_11001^B （`~major型$ `2$mj, `追加l情報$ `25^ai ）に［ 【`引数$を成す】長さ 500 用の 2 個の~byte `01f4^X ］が後続し，さらに［ ~binary内容を成す 500 個の~byte ］が後続する。 ◎ A byte string whose length is 500 would have 3 initial bytes of 0b010_11001 (major type 2, additional information 25 to indicate a two-byte length) followed by the two bytes 0x01f4 for a length of 500, followed by 500 bytes of binary content.

`~major型$ `3@mj ◎ Major type 3:

~UTF-8 `RFC3629$r として符号化された`~text~string$ （ `2§ ）。 ◎ A text string (Section 2) encoded as UTF-8 [RFC3629].＼

`引数$は、［ 当の~stringを成す~byteの個数 ］を与える。 ◎ The number of bytes in the string is equal to the argument.＼

~stringが［ 妥当でない~UTF-8連列 ］を包含している場合、 `整形式$ではあるが，`妥当$でない【！`1.2§】。 ◎ A string containing an invalid UTF-8 sequence is well-formed but invalid (Section 1.2).＼

この型は、 ヒトが可読な~text［ に解釈する／を表示する ］必要がある~system用に供され，［ 無構造な~byte列 ］と［ 指定された［ `~repertoire$（~Unicodeのそれ）, 符号化法（~UTF-8） ］を伴う~text ］を区別することを許容する。 ◎ This type is provided for systems that need to interpret or display human-readable text, and allows the differentiation between unstructured bytes and text that has a specified repertoire (that of Unicode) and encoding (UTF-8).＼

~JSONなどの形式とは対照的に、 この型における~Unicode文字は，~escapeされることは決してない。 したがって， `000A^U （改行文字）は、 ~string内では，常に~byte `0a^X として表現される — 決して，~byte列［ `5c6e^X （文字［ "`\^c" , "`n^c" ］が成す並び）／ `5c7530303061^X （文字［ "`\^c", "`u^c", "`0^c", "`0^c", "`0^c", "`a^c" ］が成す並び） ］としてではなく。 ◎ In contrast to formats such as JSON, the Unicode characters in this type are never escaped. Thus, a newline character (U+000A) is always represented in a string as the byte 0x0a, and never as the bytes 0x5c6e (the characters "\" and "n") nor as 0x5c7530303061 (the characters "\", "u", "0", "0", "0", and "a").

`~major型$ `4@mj ◎ Major type 4:

~data~itemたちが成す`~array$。 `~array$は、 他の形式においては［ ~list（ `list^en ）, 連列（ `sequence^en ）, ~tuple（ `tuple^en ） ］とも呼ばれる （ “~CBOR連列” `RFC8742$r は、 少し異なる何かであるが）。 ◎ An array of data items. In other formats, arrays are also called lists, sequences, or tuples (a "CBOR sequence" is something slightly different, though [RFC8742]).＼

`引数$は、［ 当の`~array$を成す~data~itemの個数 ］を与える。 ◎ The argument is the number of data items in the array.＼

`~array$内の~itemは、 すべてが同じ型になる必要はない。 例えば， 10 個の~itemを包含する`~array$は、 各~itemの型が何であれ， `先頭~byte$ `100_01010^B （`~major型$ `4$mj, `追加l情報$ `10^ai （長さ用）） に［ 10 個の~item ］が後続することになる。 ◎ Items in an array do not need to all be of the same type. For example, an array that contains 10 items of any type would have an initial byte of 0b100_01010 (major type 4, additional information 10 for the length) followed by the 10 remaining items.

`~major型$ `5@mj ◎ Major type 5:

`~entry@ たちが成す`~map$。 各`~entry$は、 ~~連続する 2 個の~data~itemが成す~pairで与えられ， 順に当の`~entry$の［ `~key@, `値@ ］を与える。 `~map$は、 他の形式においては［ ~table（ `table^en ）／ 辞書（ `dictionary^en ）／ ~hash（ `hash^en ）／ （~JSONにおいては）~object（ `object^en ） ］とも呼ばれる。 ◎ A map of pairs of data items. Maps are also called tables, dictionaries, hashes, or objects (in JSON).＼ A map is comprised of pairs of data items, each pair consisting of a key that is immediately followed by a value.＼

【 ~entryは，原文では “`key/value piar^en” と称されるが、 この訳では，各種~web標準に共通して利用される名称 “~entry（ `entry^en ）” を利用する。 】

`引数$は、 当の`~map$を成す`~entry$の個数を与える。 例えば，`~map$が 9 個の`~entry$を包含するならば、 `先頭~byte$は `101_01001^B （`~major型$ `5$mj, `追加l情報$ `9^ai （`~entry$の個数~用））になり， 18 個の~itemが後続することになる — ［ 1 個目, 2 個目 ］の~itemは 1 個目の`~entry$の［ `~key$, `値$ ］, ［ 3 個目, 4 個目 ］の~itemは 2 個目の`~entry$の［ `~key$, `値$ ］, 等々。 ◎ The argument is the number of pairs of data items in the map. For example, a map that contains 9 pairs would have an initial byte of 0b101_01001 (major type 5, additional information 9 for the number of pairs) followed by the 18 remaining items. The first item is the first key, the second item is the first value, the third item is the second key, and so on.＼

`~map$内の~itemたちは`~entry$を成すよう~pairで来るので、 ~itemの総数は常に偶数になる — `~map$が奇数~個の~itemを包含する場合 （すなわち、 最後の`~entry$の`~key$を与える~data~itemの後に，`値$を与える~data~itemが無い場合）、 `整形式$でない。 ◎ Because items in a map come in pairs, their total number is always even: a map that contains an odd number of items (no value data present after the last key data item) is not well-formed.＼

`~map$内に重複な`~key$がある場合、 `整形式$にはなり得るが，`妥当$ではない — したがって，それは、 復号が非決定的になる原因になる — `5.6§ も見よ。 ◎ A map that has duplicate keys may be well-formed, but it is not valid, and thus it causes indeterminate decoding; see also Section 5.6.

`~major型$ `6@mj ◎ Major type 6:

`~tag$。 各`~tag$は、 次の 2 つからなる：

• `~tag番号$ ⇒ ~integer ~IN 範囲 { 0 〜 2`64^sup ~MINUS 1 } であり， `引数$として与えられる。
• `~tag内容$ ⇒ `~tag$に封入された［ `~head$に後続する 1 個の`符号化された~data~item$ ］として与えられる。

◎ A tagged data item ("tag") whose tag number, an integer in the range 0..264-1 inclusive, is the argument and whose enclosed data item (tag content) is the single encoded data item that follows the head. See Section 3.4.

`~major型$ `7@mj ◎ Major type 7:

`~float$／ `単純~値$／ `~break$ ◎ Floating-point numbers and simple values, as well as the "break" stop code. See Section 3.3.

これらの 8 種の`~major型$から、［ ~data~itemの`先頭~byte$にアリな 256 通りの値 ］のうちどれが利用されるかを示す単純な表t（ `表t 7＠#jumptable$ ）が導かれる。 ◎ These eight major types lead to a simple table showing which of the 256 possible values for the initial byte of a data item are used (Table 7).

`~major型$ ~IN { `6$mj, `7$mj } においては、 アリな値の多くは，将来の仕様~用に予約される。 これらの値についての さらなる情報は `9§ を見よ。 ◎ In major types 6 and 7, many of the possible values are reserved for future specification. See Section 9 for more information on these values.

~CBORにより定義される`~major型$は、 `表t 1＠#major-type-table$ に要約される — 今の所は `3.2§ は無視して。 この表tにおける~number %N は、 `引数$を表す。 ◎ Table 1 summarizes the major types defined by CBOR, ignoring Section 3.2 for now. The number N in this table stands for the argument.

3.2. 一部の~major型~用の不定な長さ

`~data~item$のうち［ `~array$, `~map$, `~byte~string$, `~text~string$ ］は、 `追加l情報$に値 `31^ai を利用して， `不定長@ （ `indefinite-length^en ） になるよう符号化できる — `確定長@ （ `definite-length^en ）は、 その否定を表す。 これは、 当の~itemの符号化は［ `~array$を成す~itemの個数／ `~map$を成す`~entry$の個数／ ~stringの総-長さ ］が既知になる前に始まる必要がある場合に有用になる。 （~data~itemを成す すべてが既知になる前に，その送信を開始する能は、 当の~data~itemの中で `~streamして@ いると称されることが多い。） ◎ Four CBOR items (arrays, maps, byte strings, and text strings) can be encoded with an indefinite length using additional information value 31. This is useful if the encoding of the item needs to begin before the number of items inside the array or map, or the total length of the string, is known. (The ability to start sending a data item before all of it is known is often referred to as "streaming" within that data item.)

`不定長$な［ `~array$／`~map$ ］が どう処されるかは、 `不定長$な~string【！（`~byte~string$, `~text~string$）】とは異なる。 ◎ Indefinite-length arrays and maps are dealt with differently than indefinite-length strings (byte strings and text strings).

83        `— ~array, 長さ 3^cmt
   01     `— 1^cmt
   82     `— ~array, 長さ 2^cmt
      02  `— 2^cmt
      03  `— 3^cmt
   82     `— ~array, 長さ 2^cmt
      04  `— 4^cmt
      05  `— 5^cmt

83        -- Array of length 3
   01     -- 1
   82     -- Array of length 2
      02  -- 2
      03  -- 3
   82     -- Array of length 2
      04  -- 4
      05  -- 5

`9f018202039f0405ffff^X
9F        `— 不定長な~arrayの開始^cmt
   01     `— 1^cmt
   82     `— ~array, 長さ 2^cmt
      02  `— 2^cmt
      03  `— 3^cmt
   9F     `— 不定長な~arrayの開始^cmt
      04  `— 4^cmt
      05  `— 5^cmt
      FF  `— ~break （内縁~array）^cmt
   FF     `— ~break （外縁~array）^cmt

0x9f018202039f0405ffff
9F        -- Start indefinite-length array
   01     -- 1
   82     -- Array of length 2
      02  -- 2
      03  -- 3
   9F     -- Start indefinite-length array
      04  -- 4
      05  -- 5
      FF  -- "break" (inner array)
   FF     -- "break" (outer array)

`9f01820203820405ff^X
9F        `— 不定長な~arrayの開始^cmt
   01     `— 1^cmt
   82     `— ~array, 長さ 2^cmt
      02  `— 2^cmt
      03  `— 3^cmt
   82     `— ~array, 長さ 2^cmt
      04  `— 4^cmt
      05  `— 5^cmt
   FF     `— ~break^cmt

0x9f01820203820405ff
9F        -- Start indefinite-length array
   01     -- 1
   82     -- Array of length 2
      02  -- 2
      03  -- 3
   82     -- Array of length 2
      04  -- 4
      05  -- 5
   FF     -- "break"

`83018202039f0405ff^X
83        `— ~array, 長さ 3^cmt
   01     `— 1^cmt
   82     `— ~array, 長さ 2^cmt
      02  `— 2^cmt
      03  `— 3^cmt
   9F     `— 不定長な~arrayの開始^cmt
      04  `— 4^cmt
      05  `— 5^cmt
      FF  `— ~break^cmt

0x83018202039f0405ff
83        -- Array of length 3
   01     -- 1
   82     -- Array of length 2
      02  -- 2
      03  -- 3
   9F     -- Start indefinite-length array
      04  -- 4
      05  -- 5
      FF  -- "break"

`83019f0203ff820405^X
83        `— ~array, 長さ 3^cmt
   01     `— 1^cmt
   9F     `— 不定長な~arrayの開始^cmt
      02  `— 2^cmt
      03  `— 3^cmt
      FF  `— ~break^cmt
   82     `— ~array, 長さ 2^cmt
      04  `— 4^cmt
      05  `— 5^cmt

0x83019f0203ff820405
83        -- Array of length 3
   01     -- 1
   9F     -- Start indefinite-length array
      02  -- 2
      03  -- 3
      FF  -- "break"
   82     -- Array of length 2
      04  -- 4
      05  -- 5

`bf6346756ef563416d7421ff^X
BF           `— 不定長な~mapの開始^cmt
   63        `— 1 個目の~key（ ~UTF-8~string, 長さ 3 ）^cmt
      46756e `—   "Fun"^cmt
   F5        `— 1 個目の値, true^cmt
   63        `— 2 個目の~key（ ~UTF-8~string, 長さ 3 ）^cmt
      416d74 `—   "Amt"^cmt
   21        `— 2 個目の値（ −2 ）^cmt
   FF        `— ~break^cmt

0xbf6346756ef563416d7421ff
BF           -- Start indefinite-length map
   63        -- First key, UTF-8 string length 3
      46756e --   "Fun"
   F5        -- First value, true
   63        -- Second key, UTF-8 string length 3
      416d74 --   "Amt"
   21        -- Second value, -2
   FF        -- "break"

`010_11111^B `010_00100^B 0xaabbccdd `010_00011^B 0xeeff99 `111_11111^B
5F              `— 不定長な~byte~stringの開始^cmt
   44           `— ~byte~string, 長さ 4^cmt
      aabbccdd  `— ~byte列の内容^cmt
   43           `— ~byte~string, 長さ 3^cmt
      eeff99    `— ~byte列の内容^cmt
   FF           `— ~break^cmt

0b010_11111 0b010_00100 0xaabbccdd 0b010_00011 0xeeff99 0b111_11111
5F              -- Start indefinite-length byte string
   44           -- Byte string of length 4
      aabbccdd  -- Bytes content
   43           -- Byte string of length 3
      eeff99    -- Bytes content
   FF           -- "break"

3.3. ~floatと単純~値

他すべての`~major型$と同じく、 `追加l情報$ `24^ai は，単-~byteによる拡張を表す — それには、 `単純~値$を表現する，追加的な（ 1 個の）~byteが後続する （混同を最小化するため、 この~byteに利用される値は 32 以上に限られる）。 これは、 `~head$の構造を保守する： 他の`~major型$と同じく、 これらの長さは，常に［ `先頭~byte$内の`追加l情報$ ］に依存する。 `表t 4＠#fpnoconttbl2$ に， `単純~値$に可用な数量-値, アテガわれた意味論を挙げる。 ◎ As with all other major types, the 5-bit value 24 signifies a single-byte extension: it is followed by an additional byte to represent the simple value. (To minimize confusion, only the values 32 to 255 are used.) This maintains the structure of the initial bytes: as for the other major types, the length of these always depends on the additional information in the first byte. Table 4 lists the numeric values assigned and available for simple values.

符号化器は、 `先頭~byte$ `f8^X （`~major型$ `7$mj, `追加l情報$ `24^ai ）に継続して， `20^X （ 32 ）未満の~byteを発行してはナラナイ。 そのような 2 個の~byteが成す連列は、 `整形式$でない。 （このことは、［ 符号化器は［ `false$i ／ `true$i ／ `null$i ／ `undefined$i ］を 2 個の~byteとして符号化し得ない ］こと，および［ これら 1 個の~byteからなる表現~変種に限り`整形式$になる ］ことを含意する — より一般には、 どの`単純~値$も，その表現~変種は一つに限られる）。 ◎ An encoder MUST NOT issue two-byte sequences that start with 0xf8 (major type 7, additional information 24) and continue with a byte less than 0x20 (32 decimal). Such sequences are not well-formed. (This implies that an encoder cannot encode false, true, null, or undefined in two-byte sequences and that only the one-byte variants of these are well-formed; more generally speaking, each simple value only has a single representation variant).

`追加l情報$［ `25^ai ／ `26^ai ／ `27^ai ］は、［ `半-精度$／`単-精度$／`倍-精度$ ］`~float$用にある。 これらの`~float$値は、 適切な~sizeの追加的な~byte列~内に符号化される。 （`半-精度~float$についての他の情報は `D§ を見よ。） ◎ The 5-bit values of 25, 26, and 27 are for 16-bit, 32-bit, and 64-bit IEEE 754 binary floating-point values [IEEE754]. These floating-point values are encoded in the additional bytes of the appropriate size. (See Appendix D for some information about 16-bit floating-point numbers.)

3.4. ~itemの~tag付け

~CBORにおける~data~itemは、 ある`~tag$内に封入することにより，何らかの追加的な意味論を与えれる — `~tag$の意味論は、 `~tag番号@ （ `tag number^en ）により一意に識別される。 `~tag$の`~major型$は `6$mj であり， その`引数$【！（ `3§ ）】が`~tag番号$を指示する。 各`~tag$は、 `~tag内容@ （ `tag content^en ） — 当の~tagに封入された 1 個の~data~item — を包含する （ある`~tag$が，その`~tag内容$に更なる構造を要求する場合、 封入された~data~itemが，その構造を供する）。 用語 `~tag@ は、［ `~tag番号$, `~tag内容$ ］からなる~data~item全体を指す 【すなわち、~tag自身も`~data~item$である】 — `~tag内容$は、 ~tag付けられた~data~itemである。 ◎ In CBOR, a data item can be enclosed by a tag to give it some additional semantics, as uniquely identified by a tag number. The tag is major type 6, its argument (Section 3) indicates the tag number, and it contains a single enclosed data item, the tag content. (If a tag requires further structure to its content, this structure is provided by the enclosed data item.) We use the term tag for the entire data item consisting of both a tag number and the tag content: the tag content is the data item that is being tagged.

【 所与の~data~itemを形容する語 “~tag付き（ `tagged^en ）” は、 当の~data~itemが，ある`~tag$の`~tag内容$であることをいう （ “~tag付ける” は、そうなるようにすることをいう）。 しかしながら、 “~tag付き~data~item” が実際には`~tag$を意味する箇所も少数あり，紛らわしいので、 この訳では，ほとんどの “~tag付き~data~item” を［ ~tag内容／~tag ］のうち適切な方に置換している。 】

例えば，長さ 12 の`~byte~string$は、 `~tag番号$ `2$tag を伴う`~tag$で~markされたと見做すならば， 無符号な`~bignum$であることを指示する。 `符号化された~data~item$は、 `先頭~byte$ `110_00010^B （`~major型$ `6$mj, `追加l情報$ `2^ai （`~tag番号$用）） に，符号化された`~tag内容$として次が順に後続することになる ⇒＃ `010_01100^B （`~major型$ `2$mj, `追加l情報$ `12^ai （長さ用））, 当の`~bignum$を成す 12 個の~byte ◎ For example, assume that a byte string of length 12 is marked with a tag of number 2 to indicate it is an unsigned bignum (Section 3.4.3). The encoded data item would start with a byte 0b110_00010 (major type 6, additional information 2 for the tag number) followed by the encoded tag content: 0b010_01100 (major type 2, additional information 12 for the length) followed by the 12 bytes of the bignum.

`拡張された汎用~data~model$においては、 `~tag番号$の定義は，［ 当の~tag番号で伝達される追加的な意味論 ］を述べる。 これらの意味論は、 一部の`~tag$と他の~data~item — 一部の［ 基本的な`汎用~data~model$で表現できる~data~item ］も含む — との等価性を含むこともある。 一例として， `~bignum$ `c24101^X は、 その`~tag内容$は 1 個の~byte `01^X を伴う`~byte~string$であり， `~integer$ 1 に等価になる — それは、［ `01^X ／ `1801^X ／ `190001^X ］として符号化することもできる。 当の~tag定義は、 汎用な符号化器~用に推奨される選好される直列化（ `4.1§ ）を指定することもあろう — それは、 `~tag$を使役する表現よりも， 基本的な`汎用~data~model$による表現を選好することもあろう。 ◎ In the extended generic data model, a tag number's definition describes the additional semantics conveyed with the tag number. These semantics may include equivalence of some tagged data items with other data items, including some that can be represented in the basic generic data model. For instance, 0xc24101, a bignum the tag content of which is the byte string with the single byte 0x01, is equivalent to an integer 1, which could also be encoded as 0x01, 0x1801, or 0x190001. The tag definition may specify a preferred serialization (Section 4.1) that is recommended for generic encoders; this may prefer basic generic data model representations over ones that employ a tag.

~tag定義は、 通例的に［ どの~data~itemが，その`~tag内容$として妥当になるか ］を定義する。 ~tag定義は、 その内容を［ この文書にて定義される`~tag$が行うとおり，ごく特定の構文-構造に制約する ］こともあれば［ より意味論的に定義する ］こともある。 後者の例として、 `~tag番号$【！~tag】 ~IN { `40^tag, `1040^tag } が， `~array$を表現する複数の仕方を どう受容するかがある `RFC8746$r 。 ◎ The tag definition usually defines which nested data items are valid for such tags. Tag definitions may restrict their content to a very specific syntactic structure, as the tags defined in this document do, or they may define their content more semantically. An example for the latter is how tags 40 and 1040 accept multiple ways to represent arrays [RFC8746].

規約に関する事として、 多くの`~tag$は，`~tag内容$として［ `null$i, `undefined$i ］値を受容しない — 代わりに，`~tag$が占める所に値［ `null$i ／ `undefined$i ］を利用できることを期待する — `3.4.2§ は、［ ある特定の`~tag$用の更なる考慮点 ］として［ 応用~protocol, ~platform型への対応付け ］における，この規約の取扱いを供する。 ◎ As a matter of convention, many tags do not accept null or undefined values as tag content; instead, the expectation is that a null or undefined value can be used in place of the entire tag; Section 3.4.2 provides some further considerations for one specific tag about the handling of this convention in application protocols and in mapping to platform types.

復号器は、 あらゆる`~tag番号$の`~tag$を解する必要はない。 また，応用における`~tag$の価値は少ししかないこともあろう — そこでは、［ ~data~flowにおける各~itemの意味論上の意味 ］を知るものは，［ 特定0の`~data~item$を作成している実装, その~streamを復号している実装 ］である。 この仕様における`~tag$の首な目的は、 日付など，共通な~data型を定義することにある。 第二の目的は、［ 当の`~data~item$は、 異なる形式に翻訳される必要があり， ~itemの内容についての~hintを要求している ］ことが予知されるとき，変換~用の~hintを供することにある。 `~tag$の意味論を解することは、 復号器にとっては任意選択~である。 復号器は、 単純に — すなわち，当の`~tag$による追加的な意味論を解釈することなく — 当の応用に［ `~tag番号$, `~tag内容$ ］を呈示できる。 ◎ Decoders do not need to understand tags of every tag number, and tags may be of little value in applications where the implementation creating a particular CBOR data item and the implementation decoding that stream know the semantic meaning of each item in the data flow. The primary purpose of tags in this specification is to define common data types such as dates. A secondary purpose is to provide conversion hints when it is foreseen that the CBOR data item needs to be translated into a different format, requiring hints about the content of items. Understanding the semantics of tags is optional for a decoder; it can simply present both the tag number and the tag content to the application, without interpreting the additional semantics of the tag.

`~tag$は、 その`~tag内容$【！data item it encloses】に意味論を適用する。 ~tagは入子にできる — `~tag$ %A の`~tag内容$ %B もまた`~tag$である場合、 %B の`~tag内容$に %B を適用した結果に %A が適用される。 ◎ A tag applies semantics to the data item it encloses. Tags can nest: if tag A encloses tag B, which encloses data item C, tag A applies to the result of applying tag B on data item C.

~IANAは、 `9.2§ にて述べられるとおり， `~tag番号$の~registryを保守する。 `表t 5＠#tagvalues$ は、 `RFC7049$r にて定義された`~tag番号$の~listを — この節を成す残りの定義と伴に — 供する （ `RFC7049$r は、 ~tag番号 `35^tag も定義した — この~tag番号の論点は、 `3.4.5.3§ に従う）。 他の`~tag番号$のうち多くは、 `RFC7049$r の公表~後に定義されたことに注意 — 完全な~listは `9.2§ にて述べる~registryを見よ。 ◎ IANA maintains a registry of tag numbers as described in Section 9.2. Table 5 provides a list of tag numbers that were defined in [RFC7049] with definitions in the rest of this section. (Tag number 35 was also defined in [RFC7049]; a discussion of this tag number follows in Section 3.4.5.3.) Note that many other tag numbers have been defined since the publication of [RFC7049]; see the registry described at Section 9.2 for the complete list.

`~tag$は、 概念的には — 直列化（逆直列化）の時点ではなく — `汎用~data~model$において解釈される。 少数の`~tag$ （現時点では，`~tag番号$ `25^tag, `29^tag `IANA.cbor-tags$r ） は、［ 直列化／逆直列化 ］の時点における処理を要求し得る意味論を伴って登録された — 符号化器は，［ 直列化において，`~data~item$たちを正確に どの順序で符号化するか ］を制御-下におく必要があり、 復号器は，［ 逆直列化において，`~data~item$たちが正確に どの順序で符号化されたか ］を自覚する必要がある。 このことは、 これらの`~tag$は，任意な汎用な~CBOR［ 符号化器／復号器 ］（それは、 ~data~model~levelにおける`~map$を成す`~entry$用には，［ 直列化／逆直列化 ］の順序を反映しないかもしれない） の上層には実装し得ないことを意味する — したがって，それらの実装は、 概して，汎用［ 符号化器／復号器 ］の中に統合される必要がある。 新たな`~tag$には、 この特質を伴う定義は`推奨されない^2119。 ◎ Conceptually, tags are interpreted in the generic data model, not at (de-)serialization time. A small number of tags (at this time, tag number 25 and tag number 29 [IANA.cbor-tags]) have been registered with semantics that may require processing at (de-)serialization time: the decoder needs to be aware of, and the encoder needs to be in control of, the exact sequence in which data items are encoded into the CBOR data item. This means these tags cannot be implemented on top of an arbitrary generic CBOR encoder/decoder (which might not reflect the serialization order for entries in a map at the data model level and vice versa); their implementation therefore typically needs to be integrated into the generic encoder/decoder. The definition of new tags with this property is NOT RECOMMENDED.

~IANAは、 `~tag番号$［ `65535^tag, `4294967295^tag, `18446744073709551615^tag ］ （ 2 進数として全桁が 1 になるもの — 順に， 16 ~bit, 32 ~bit, 64 ~bit） を割振った。 これらは、実装者が［ 特定の`~tag$が在ると期待される所に無いこと 【！either the presence of a specific tag or absence of a tag】 ］を［ 1 個の~integerを成す~data構造で指示する【？】 ］よう求める場合の便利として利用され得る。 その割振りは、 `CBOR-TAGS$r `§ 10＠https://datatracker.ietf.org/doc/html/draft-bormann-cbor-notable-tags-02#section-10$ にて述べられる。 これらの`~tag$は、 実際の`~data~item$として生じるよう意図されたものではない — 実装は、 そのように生じたものを~errorとして~flagしてもヨイ。 ◎ IANA allocated tag numbers 65535, 4294967295, and 18446744073709551615 (binary all-ones in 16-bit, 32-bit, and 64-bit). These can be used as a convenience for implementers who want a single-integer data structure to indicate either the presence of a specific tag or absence of a tag. That allocation is described in Section 10 of [CBOR-TAGS]. These tags are not intended to occur in actual CBOR data items; implementations MAY flag such an occurrence as an error.

各~protocolは、 `汎用~data~model$を拡張できる： ◎ Protocols can extend the generic data model (Section 2)＼

• `~tag番号$ ~IN { `0$tag, `1$tag } を利用することにより， ある時点の時刻を表現している~data~itemで ◎ with data items representing points in time by using tag numbers 0 and 1,＼
• `~tag番号$ ~IN { `2$tag, `3$tag } を利用することにより，任意な~sizeの`~integer$で ◎ with arbitrarily sized integers by using tag numbers 2 and 3,＼
• `~tag番号$ ~IN { `4$tag, `5$tag } を利用することにより，任意な［ ~size, 精度 ］の`~float$値で ◎ and with floating-point values of arbitrary size and precision by using tag numbers 4 and 5.

C2                        `— ~tag 2^cmt
   49                     `— ~byte~string, 長さ 9^cmt
      010000000000000000  `— ~byte列の内容^cmt

C2                        -- Tag 2
   49                     -- Byte string of length 9
      010000000000000000  -- Bytes content

C4             `— ~tag 4^cmt
   82          `— ~array, 長さ 2^cmt
      21       `— −2^cmt
      19 6ab3  `— 27315^cmt

C4             -- Tag 4
   82          -- Array of length 2
      21       -- -2
      19 6ab3  -- 27315

C5             `— ~tag 5^cmt
   82          `— ~array, 長さ 2^cmt
      20       `— −1^cmt
      03       `— 3^cmt

C5             -- Tag 5
   82          -- Array of length 2
      20       -- -1
      03       -- 3

4.1. 選好される直列化

~CBORは、 ~data~model~levelにおける一部の値に対し，複数種の直列化を供する。 多くの応用に対しては、 符号化器は，常に選好される直列化（選好される符号化法）を選ぶことが望ましい — しかしながら，~CBORの現~versionは、［ 符号化器, 復号器 ］どちらにも，この選好を施行する負担を課さない。 ◎ For some values at the data model level, CBOR provides multiple serializations. For many applications, it is desirable that an encoder always chooses a preferred serialization (preferred encoding); however, the present specification does not put the burden of enforcing this preference on either the encoder or decoder.

一部の拘束された復号器は、 選好されない直列化を復号する能が制限され得る — 例えば， ある応用にて`期待され$る`~integer$が 1000000000 （ 10 億）未満に限られる場合、 当の復号器は［ `~integer$における 64 ~bit`引数$を復号するために必要になる~code ］を外すこともあろう。 ある符号化器が，選好される直列化（ “選好される符号化器” ）を常に利用する場合、 この応用において生じ得る~numberは，この復号器と相互運用する。 選好される符号化器は、 一般に，より普遍的に — 例えば，常に 64 ~bit`~integer$を利用するものよりも — 相互運用可能になる （また、無駄にもなりにくい）。 ◎ Some constrained decoders may be limited in their ability to decode non-preferred serializations: for example, if only integers below 1_000_000_000 (one billion) are expected in an application, the decoder may leave out the code that would be needed to decode 64-bit arguments in integers. An encoder that always uses preferred serialization ("preferred encoder") interoperates with this decoder for the numbers that can occur in this application. Generally speaking, a preferred encoder is more universally interoperable (and also less wasteful) than one that, say, always uses 64-bit integers.

類似に，拘束された符号化器は、 自身が~supportする表現~変種の多様さが制限されることもある — 選好される直列化を発しないなど（ “変種~符号化器” ）。 一例として，ある拘束された符号化器は、 自身が符号化する`~integer$用には［ 短い表現が可用な場合でも，常に 32 ~bit変種を利用する ］よう設計されることもあろう （ 64 ~bit変種でしか表現し得ない`~integer$を必要とする応用は無いと見做すならば）。 したがって， 復号器のうち［ 選好される直列化に限り受信する ］ことには依拠しないもの（ “多様性に寛容な復号器” ）は、 より普遍的に相互運用可能になると言える （それは、 選好される直列化を受信している事例に対しては， かなり上手く最適化できるかもしれないが）。 ~CBOR復号器の全部的な実装は、 定義により，多様性に寛容である — その区別が関連するのは、［ ~CBOR復号器の拘束された実装が，変種~符号化器に出会った場合 ］に限られる。 ◎ Similarly, a constrained encoder may be limited in the variety of representation variants it supports such that it does not emit preferred serializations ("variant encoder"). For instance, a constrained encoder could be designed to always use the 32-bit variant for an integer that it encodes even if a short representation is available (assuming that there is no application need for integers that can only be represented with the 64-bit variant). A decoder that does not rely on receiving only preferred serializations ("variation-tolerant decoder") can therefore be said to be more universally interoperable (it might very well optimize for the case of receiving preferred serializations, though). Full implementations of CBOR decoders are by definition variation tolerant; the distinction is only relevant if a constrained implementation of a CBOR decoder meets a variant encoder.

選好される直列化は、 `引数$【！`3§ 】を表現するときに，常に最短な形を利用する。 それはまた、 `~float$の符号化法として［ 符号化されている値を保全する最短な形 ］を利用する。 ◎ The preferred serialization always uses the shortest form of representing the argument (Section 3); it also uses the shortest floating-point encoding that preserves the value being encoded.

`~float$値~用に選好される直列化は、 その値を保全する最短な`~float$に符号化することである — 例： ~number 5.5 用には `f94580^X 【`半-精度$】／ ~number 5555.5 用には `fa45ad9c00^X 【`倍-精度$】。 各種~NaN値に対しても、 符号化が短くなる方が選好される — より短い方において、 仮数部の右側を~bit 0 で補充することにより，元の~NaN値を~~再構成できるならば （多くの応用~用には、 単独の~NaN符号化 `f97e00^X 【`半-精度$】で足りる）。 【例：`倍-精度$ ~NaNは、等価な［`単-精度$／`半-精度$］~NaNが在るならば，それらのうち最短なものに符号化する。】 ◎ The preferred serialization for a floating-point value is the shortest floating-point encoding that preserves its value, e.g., 0xf94580 for the number 5.5, and 0xfa45ad9c00 for the number 5555.5. For NaN values, a shorter encoding is preferred if zero-padding the shorter significand towards the right reconstitutes the original NaN value (for many applications, the single NaN encoding 0xf97e00 will suffice).

当の~itemの直列化を開始した時点で長さが既知であるときには、 `確定長$な符号化法が選好される。 ◎ Definite-length encoding is preferred whenever the length is known at the time the serialization of the item starts.

4.2. 決定論的に符号化された~CBOR

一部の~protocolは、［ 符号化器が発する~CBORは、特定0の決定論的な形式に限る ］よう求めることもあろう — そのような~protocolは、 復号器も［ 入力が，その決定論的な形式かどうか検査する ］よう求めるかもしれない。 そのような~protocolは、［ “決定論的な形式” が何を意味するか，どの［ 符号化器／復号器 ］が，それを行うものと`期待され$るか ］を定義してもかまわない。 この節は、［ そのような決定論的な形式の基底として~serveし得る，一群の制約 ］を定義する。 ◎ Some protocols may want encoders to only emit CBOR in a particular deterministic format; those protocols might also have the decoders check that their input is in that deterministic format. Those protocols are free to define what they mean by a "deterministic format" and what encoders and decoders are expected to do. This section defines a set of restrictions that can serve as the base of such a deterministic format.

5.1. ~streamしている応用における~CBOR

`~streamして$いる応用においては、 `~data~stream$は，［ ~~連続するよう連結された，一連の`~data~item$ ］から構成され得る。 そのような環境においては，復号器は、［ すでに得られた~data~itemの終端より後にも，~dataが見出された場合 ］には，新たな~data~itemの復号を即時に始める。 ◎ In a streaming application, a data stream may be composed of a sequence of CBOR data items concatenated back-to-back. In such an environment, the decoder immediately begins decoding a new data item if data is found after the end of a previous data item.

［ ある~data~itemを成している すべての~byte ］が，即時には復号器に可用にならないこともある。 一部の復号器は、 追加的な~dataを［ 完全な~data~itemを応用に呈示できるようになる ］まで~bufferすることになる。 他の復号器は、 ~top-level~data~itemについての部分的な情報を応用に呈示し得る — すでに復号できた入子な~data~itemや， まだ完全には到着していない`~byte~string$の各部など。 そのような応用は、［ そこで応用に呈示される増分的な~data ］用に欲される保護が可用になるよう，それに見合った［ ~stream用の~securityの仕組み ］も備えなければナラナイ。 ◎ Not all of the bytes making up a data item may be immediately available to the decoder; some decoders will buffer additional data until a complete data item can be presented to the application. Other decoders can present partial information about a top-level data item to an application, such as the nested data items that could already be decoded, or even parts of a byte string that hasn't completely arrived yet. Such an application also MUST have a matching streaming security mechanism, where the desired protection is available for incremental data presented to the application.

`不定長$な符号化法を利用しないよう求める［ 応用／~protocol ］もあることに注意。 `不定長$な符号化法を利用することは、 符号化器に対し［ 長さを集計するために，すべての~dataを結集する必要をなくす ］ことを許容する一方で，復号器に対し［ 当の~itemの終端を待機している間，割振る~memory量を増やす ］ことを要求する。 これは、 ~~不都合な応用もあるかもしれない。 ◎ Note that some applications and protocols will not want to use indefinite-length encoding. Using indefinite-length encoding allows an encoder to not need to marshal all the data for counting, but it requires a decoder to allocate increasing amounts of memory while waiting for the end of the item. This might be fine for some applications but not others.

5.2. 汎用な符号化器と汎用な復号器

汎用な~CBOR復号器は、 すべての`整形式$な`~data~item$を復号でき， 結果の~data~itemを応用に呈示できる。 `C§ を見よ。 （`整形式$な~CBOR値をヒトに呈示するときには、 `8§ の診断用の記法を利用できる。） ◎ A generic CBOR decoder can decode all well-formed encoded CBOR data items and present the data items to an application. See Appendix C. (The diagnostic notation, Section 8, may be used to present well-formed CBOR values to humans.)

汎用な~CBOR符号化器は、 次を指定することを応用に許容する，応用~interfaceを供する ⇒ `整形式$な値は、 何であれ — 当の符号化器に未知な［ `単純~値$／`~tag$ ］を含めて — `~data~item$として符号化されることになる ◎ Generic CBOR encoders provide an application interface that allows the application to specify any well-formed value to be encoded as a CBOR data item, including simple values and tags unknown to the encoder.

~CBOR~dataは、 `整形式$であっても`妥当$になるとは限らない — ~CBORは、 そのような事例を最小化しようと試みるが。 例えば，符号化された`~text~string$ `62c0ae^X は、 妥当な~UTF-8を包含しないので， `妥当$な`~data~item$ではない （ `RFC3629$r は、 常に最短な形を利用することを要求するので）。 また，特定の`~tag$は、［ 何かにより違反され得る意味論上の拘束 ］を課すこともある — 一例として、 別の`~tag$を封入している`~bignum$により／ `~tag番号$ `0$tag を伴う`~tag$のうち，`~tag内容$が［ `~byte~string$であるもの／ `~text~string$であるが `date-time^P 生成規則 `RFC3339$r に合致しないもの ］により。 汎用な［ 符号化器／復号器 ］には、 `妥当$でない~dataの処理を可能化するために， 応用~interface用に不自然な選択肢をとらせる要件は無い。 汎用な［ 符号化器／復号器 ］には、［ `単純~値$／`~tag$ ］（順不同）を回送することが`期待され$る — それらに特有な符号点が，当の［ 符号化器／復号器 ］が書かれた時点では登録-済みでなかったとしても（ `5.4§ ）。 ◎ Even though CBOR attempts to minimize these cases, not all well-formed CBOR data is valid: for example, the encoded text string 0x62c0ae does not contain valid UTF-8 (because [RFC3629] requires always using the shortest form) and so is not a valid CBOR item. Also, specific tags may make semantic constraints that may be violated, for instance, by a bignum tag enclosing another tag or by an instance of tag number 0 containing a byte string or containing a text string with contents that do not match the date-time production of [RFC3339]. There is no requirement that generic encoders and decoders make unnatural choices for their application interface to enable the processing of invalid data. Generic encoders and decoders are expected to forward simple values and tags even if their specific codepoints are not registered at the time the encoder/decoder is written (Section 5.4).

5.3. ~itemの妥当性

`整形式$であるが`妥当$でない`~data~item$【！`1.2§】内に符号化された~dataは、 ~CBOR~data~modelにおいて解釈するときに，問題になる。 ~CBORに基づく~protocolは、 何~層かにわたって — より低い層は［ 自身が回送する一部の~CBOR~dataの意味論 ］を処理しないように — 指定することもできる。 これら各~層は、 自身が処理しない~dataにおける妥当性~errorには，気付き得ない — そのような~dataは、 【より上の層へ】そのまま回送しなければナラナイ。 `妥当$でない`~data~item$の意味論を処理する最初の層は、 次に挙げるいずれかの選択肢に絞らなければなければナラナイ： ◎ A well-formed but invalid CBOR data item (Section 1.2) presents a problem with interpreting the data encoded in it in the CBOR data model. A CBOR-based protocol could be specified in several layers, in which the lower layers don't process the semantics of some of the CBOR data they forward. These layers can't notice any validity errors in data they don't process and MUST forward that data as-is. The first layer that does process the semantics of an invalid CBOR item MUST pick one of two choices:

1. 問題になり得る~itemを~error~markerに置換して， その次の~itemの処理を継続する ◎ Replace the problematic item with an error marker and continue with the next item, or
2. ~errorを発行して，処理をまるごと停止する。 ◎ Issue an error and stop processing altogether.

~CBORに基づく~protocolは、 各~種類の［ 自身が遭遇するかもしれない`妥当$でない~item ］に対し，［ その復号器は，上に挙げた~optionのうちどれを採る ］かを指定しなければナラナイ。 ◎ A CBOR-based protocol MUST specify which of these options its decoders take for each kind of invalid item they might encounter.

そのような問題は、［ ~CBORの基本的な妥当性~level, `~tag$の文脈（~tagの妥当性） ］どちらにおいても生じ得る。 ◎ Such problems might occur at the basic validity level of CBOR or in the context of tags (tag validity).

5.4. 妥当性と発展

妥当性~検査ngを伴う復号器は、［ 妥当性~errorを伴う~data~itemを依拠-可能に検出する労 ］を費やすことになる。 例えば，そのような復号器は、［ これまでの各~下位節に挙げた いずれかの妥当性~error ］を伴う`~data~item$に対し［ ~errorを報告する（かつ，~dataを返さない）~API ］を備える必要がある。 ◎ A decoder with validity checking will expend the effort to reliably detect data items with validity errors. For example, such a decoder needs to have an API that reports an error (and does not return data) for a CBOR data item that contains any of the validity errors listed in the previous subsection.

［ `~CBOR~tag~registry^cite（ `9.2§ ）内に定義された，一群の`~tag$ ］および［ `~CBOR単純~値~registry^cite （ `9.1§ ）内に定義された，一群の単純~値 ］は、 いつでも［ ある汎用な復号器により解される集合 ］を超えて成長し得る。 妥当性を検査する復号器は、 そのような自身が認識しない事例に遭遇したときには， 次に挙げる いずれかを行える： ◎ The set of tags defined in the "Concise Binary Object Representation (CBOR) Tags" registry (Section 9.2), as well as the set of simple values defined in the "Concise Binary Object Representation (CBOR) Simple Values" registry (Section 9.1), can grow at any time beyond the set understood by a generic decoder. A validity-checking decoder can do one of two things when it encounters such a case that it does not recognize:

• ~errorを報告する（~dataを返すことなく）。 この事例を~errorとして扱うことは、 硬直化の原因になり得るので，奨励されないことに注意。 この~error自体は、 妥当性~errorではない。 この種類の~errorは、［ これが復号器にとって既知な事例であったなら、 当の復号器は，妥当性~検査ngを遂行することになる ］場合に，当の復号器により提起される見込みが高い。 ◎ It can report an error (and not return data). Note that treating this case as an error can cause ossification and is thus not encouraged. This error is not a validity error, per se. This kind of error is more likely to be raised by a decoder that would be performing validity checking if this were a known case.
• 当の復号器を~callしている応用に向けて， 当の未知な~item（型, 値，および`~tag$用には復号した`~tag内容$）を発した上で、［ 当の復号器は、 当の［ `~tag番号$／`単純~値$ ］を認識しないこと ］を当の応用に指示する。 ◎ It can emit the unknown item (type, value, and, for tags, the decoded tagged data item) to the application calling the decoder, and then give the application an indication that the decoder did not recognize that tag number or simple value.

後者の~approachは、［ 妥当性~検査ngを~supportしない復号器においても適切になる ］ことに加え、 新たに登録された［ `単純~値$／`~tag$ ］に関して，前方-互換性を供する — ~callしている応用と符号化器を同時に更新する要件を課すことなく （このためには、 復号器の~APIは — ~callしている応用が，未知な~itemを当の~programに適切な方式で取扱えるよう — 未知な~itemを~markする能が必要になる。） ◎ The latter approach, which is also appropriate for decoders that do not support validity checking, provides forward compatibility with newly registered tags and simple values without the requirement to update the encoder at the same time as the calling application. (For this, the decoder's API needs the ability to mark unknown items so that the calling application can handle them in a manner appropriate for the program.)

妥当性~検査ngに必要な処理のうち 一部のもの（特に，`~map$用の重複~検出）は， 目に見える~costを伴い得るので、 妥当性~検査ngの~supportは， すべての~CBOR復号器に設置される要件ではない。 ◎ Since some of the processing needed for validity checking may have an appreciable cost (in particular with duplicate detection for maps), support of validity checking is not a requirement placed on all CBOR decoders.

一部の符号化器は、 それを利用する応用が，入力~dataを［ それを当の符号化器にかけた結果は、 `妥当$な~CBORになる ］ような仕方で供することに依拠する。 汎用な符号化器には、 妥当性を検査する~mode — そこでの符号化器は、［ 応用が，~~実際に~APIに適合tな~dataを供しているかどうか ］とは独立に［ 自身の出力を`妥当$な~CBORに依拠-可能に制限する ］ような~mode — も供するよう求まれることもあろう。 ◎ Some encoders will rely on their applications to provide input data in such a way that valid CBOR results from the encoder. A generic encoder may also want to provide a validity-checking mode where it reliably limits its output to valid CBOR, independent of whether or not its application is indeed providing API-conformant data.

5.5. ~number

~CBORに基づく~protocolは、［ 表現-可能な~numberの範囲と精度に対し課される制約が，言語~環境に応じて異なること ］を織り込むべきである。 例えば，基本的な~JS~number~systemは、［ すべての~numberを`~float$値として扱う ］ので［ 54 ~bit以上~要する`~integer$を復号した結果の精度 ］は~~検知されずに喪失し得る。 別の例として、 ~CBORは［ `~integer$表現~用の正負符号~bit ］を`~major型$内に保つので， ある種の長さの有符号`~integer$【！~number】は［ 代表的な~platformにおける同じ長さの有符号`~integer$の表現 ］より 1 ~bit多い （例： 8 個の~byteからなる~int64_t ~IN { −2`63^sup 〜 2`63^sup ~MINUS 1 } 用には［ 先頭~byte + 8 個の~byte ］からなる`~integer$ ~IN { −2`64^sup 〜 2`64^sup ~MINUS 1 } ）。 ~numberを利用する~protocolは、［［ 復号器, 受信している応用 ］における，~numberに対する自明でない取扱い ］に何を期待するかを定義するべきである。 ◎ CBOR-based protocols should take into account that different language environments pose different restrictions on the range and precision of numbers that are representable. For example, the basic JavaScript number system treats all numbers as floating-point values, which may result in the silent loss of precision in decoding integers with more than 53 significant bits. Another example is that, since CBOR keeps the sign bit for its integer representation in the major type, it has one bit more for signed numbers of a certain length (e.g., -264..264-1 for 1+8-byte integers) than the typical platform signed integer representation of the same length (-263..263-1 for 8-byte int64_t). A protocol that uses numbers should define its expectations on the handling of nontrivial numbers in decoders and receiving applications.

~CBORに基づく~protocolのうち，`~float$を含むものは、［ `半-精度$, `単-精度$, `倍-精度$ ］のうち，どの形式を~supportするかを制約できる。 ある~protocolは、 `~integer$しか利用しない応用に対しては， `~float$値の利用を完全に除外するよう求めることもあろう。 ◎ A CBOR-based protocol that includes floating-point numbers can restrict which of the three formats (half-precision, single-precision, and double-precision) are to be supported. For an integer-only application, a protocol may want to completely exclude the use of floating-point values.

~CBORに基づく~protocolのうち~compactさを得るために設計されたものは、 当の応用~用には［ 必要yなものより長い特定の~integer符号化法 ］を除外するよう求めることもあろう — 64 ~bit`~integer$を実装する必要を節約するためなど。 これには、 その符号化器は［ 所与の値を表現できる`~integer$表現のうち，最も~compactなもの ］を利用することになる期待がある。 しかしながら，［ ~compactな応用のうち，決定論的な符号化法を要求しないもの ］は、 必要以上に長い符号化法 （ 0 を［ `000_11001^B, 後続する 2 個の~byte `00^X ］として符号化するなど） を利用する値を — 当の応用が所与の~sizeの`~integer$を復号できる限りにおいて — 受容するべきである。 類似な考慮点は、 `~float$値にも適用される — ［ 選好される直列化, 必要以上に長いもの ］どちらも復号することが推奨される。 ◎ A CBOR-based protocol designed for compactness may want to exclude specific integer encodings that are longer than necessary for the application, such as to save the need to implement 64-bit integers. There is an expectation that encoders will use the most compact integer representation that can represent a given value. However, a compact application that does not require deterministic encoding should accept values that use a longer-than-needed encoding (such as encoding "0" as 0b000_11001 followed by two bytes of 0x00) as long as the application can decode an integer of the given size. Similar considerations apply to floating-point values; decoding both preferred serializations and longer-than-needed ones is recommended.

~CBORに基づく~protocolのうち，拘束された応用~用にあるもののうち， 特定の~number（指数が小さいかつ負でないものなど）を［ `~integer$, ［ `~decimal分数$／`~bigfloat$ ］］いずれかとして表現する選択肢を供するものは、［ `~integer$表現が直に利用されるとする，実装~品質に対する期待 ］を表出するかもしれない。 ◎ CBOR-based protocols for constrained applications that provide a choice between representing a specific number as an integer and as a decimal fraction or bigfloat (such as when the exponent is small and nonnegative) might express a quality-of-implementation expectation that the integer representation is used directly.

5.6. ~map用~keyの指定-法

符号化の応用と復号の応用は、［ `~map$内に利用される`~key$の型 ］について合意する必要がある。 ある応用が，~JSONに基づく応用と相互に作業する必要がある場合、 変換は，`~key$の形を`~text~string$に限るよう制限することにより単純~化される。 他の場合、 他の~CBOR型から`~text~string$への対応付けが指定される必要があり， これは実装~errorに至らすことが多い。 応用においては、［ `~key$は資質において数量-であって， `~key$の数量-順序付けは当の応用にとって重要である ］所では，`~key$用に直に~numberを利用することが有用になる。 ◎ The encoding and decoding applications need to agree on what types of keys are going to be used in maps. In applications that need to interwork with JSON-based applications, conversion is simplified by limiting keys to text strings only; otherwise, there has to be a specified mapping from the other CBOR types to text strings, and this often leads to implementation errors. In applications where keys are numeric in nature, and numeric ordering of keys is important to the application, directly using the numbers for the keys is useful.

`~key$用に複数の型が利用される場合、［ 利用される特定の~programming環境において，これらの型はどう表現されることになるか ］について考慮を与えるべきである。 例えば，~JS `Map^c `ECMA262$r においては、 `~key$としての［ `~integer$ 1, `~float$ 1.0 ］を判別し得ない。 このことは、 当の~protocolは，［ ある`~map$内で，`~key$として`~integer$が利用される所 ］では［ `~integer$と等しくなり得る`~float$値を`~key$として利用すること ］を避ける必要があることを意味する。 ◎ If multiple types of keys are to be used, consideration should be given to how these types would be represented in the specific programming environments that are to be used. For example, in JavaScript Maps [ECMA262], a key of integer 1 cannot be distinguished from a key of floating-point 1.0. This means that, if integer keys are used, the protocol needs to avoid the use of floating-point keys the values of which happen to be integer numbers in the same map.

復号器のうち［［ ある`~data~item$の中に入子にされた各~data~item ］を復号したなら即時に送達するもの ］（`~streamして$いる復号器）は、［ `~map$内の`~key$の一意性を見極めるために必要yな状態 ］を保たないことが多い。 類似に，符号化器のうち［ `~data~item$の符号化を［ それが入子にしている~data~itemすべてが可用になる前 ］に開始し得るもの ］（`~streamして$いる符号化器）は、［ その~data~sourceが一意性を保守することに依拠する ］ことにより，~overhead【すなわち，~keyの一意性を見極める手間】を有意に抑制するよう求めることもあろう。 ◎ Decoders that deliver data items nested within a CBOR data item immediately on decoding them ("streaming decoders") often do not keep the state that is necessary to ascertain uniqueness of a key in a map. Similarly, an encoder that can start encoding data items before the enclosing data item is completely available ("streaming encoder") may want to reduce its overhead significantly by relying on its data source to maintain uniqueness.

~CBORに基づく~protocolは、［ 受信している応用が ある`~map$内に複数個の一致する`~key$を見つけたとき，何を行うか ］を定義しなければナラナイ。 当の~protocolにおける結果の規則は、 ~CBOR~data~modelを尊重しなければナラナイ — それは、［ `~map$内に一致する`~key$がある場合、 不正形な`~map$を指示するので，復号器は~errorで停止する必要がある ］とする規則を課すかもしれないことを除いて， 一致する`~key$を伴う`~entry$たちに対し特定の取扱いを制定し得ない。 ある`~map$が重複な`~key$を伴う`~entry$を呈する場合、 汎用な復号器は， それを次に挙げるいずれかにより処理するかもしれない： ◎ A CBOR-based protocol MUST define what to do when a receiving application sees multiple identical keys in a map. The resulting rule in the protocol MUST respect the CBOR data model: it cannot prescribe a specific handling of the entries with the identical keys, except that it might have a rule that having identical keys in a map indicates a malformed map and that the decoder has to stop with an error. When processing maps that exhibit entries with duplicate keys, a generic decoder might do one of the following:

• 重複な`~key$を伴う`~map$を受容しない （すなわち，`~map$用の妥当性を施行する — `5.4§ も見よ）。 これらの汎用な復号器は、 普遍的に有用になる。 それでも、 応用によっては，自身の規則に基づいて自前の重複~検査ngを遂行する必要はあろう （一例として、 当の応用が，特定の`~map$に対しては［ `~map~key$における`~integer$値と`~float$値を同一視する ］場合）。 ◎ Not accept maps with duplicate keys (that is, enforce validity for maps, see also Section 5.4). These generic decoders are universally useful. An application may still need to perform its own duplicate checking based on application rules (for instance, if the application equates integers and floating-point values in map key positions for specific maps).
• 当の`~map$を成す すべての`~entry$を — 重複な`~key$を伴っていようが — 当の応用に渡す。 この場合、 当の応用には — その規則が`汎用~data~model$の規則と一致する場合でも — 重複な`~key$を取扱う（それについて検査する）ことが要求される。 ◎ Pass all map entries to the application, including ones with duplicate keys. This requires that the application handle (check against) duplicate keys, even if the application rules are identical to the generic data model rules.
• 重複な`~key$を伴う`~entry$のうち一部に限り，当の応用に渡す — 例：同じ`~key$を伴う`~entry$のうち，最後（あるいは最初）の`~entry$に限り外へ送達する。 応用は、 そのような汎用な復号器を特定の`~key$に対し走らす回ごとに異なる結果を取得し得る — どの値が返されるかは、 汎用な復号器の実装に応じて，および当の`~map$内の`~key$の実際の順序に基づいて異なる。 特に，応用は、 それらすべての`~entry$を見れるとは限らないので， それらの`~key$の一意性を自前では検証し得ない — 応用は、 `~key$の一意性を検証する必要がある場合には， そのような汎用な復号器を利用できないこともあろう。 これらの汎用な復号器を利用し得るのは、 当の［ ~data~sourceと転送 ］が，【どちらも】常に`妥当$な`~map$を供する状況に限られ、 当の［ ~data~sourceと転送 ］【いずれか】が攻撃され得る場合にはアリでない。 ◎ Lose some entries with duplicate keys, e.g., deliver only the final (or first) entry out of the entries with the same key. With such a generic decoder, applications may get different results for a specific key on different runs, and with different generic decoders, which value is returned is based on generic decoder implementation and the actual order of keys in the map. In particular, applications cannot validate key uniqueness on their own as they do not necessarily see all entries; they may not be able to use such a generic decoder if they need to validate key uniqueness. These generic decoders can only be used in situations where the data source and transfer always provide valid maps; this is not possible if the data source and transfer can be attacked.

汎用な復号器は、［ これら 3 種の~approachのうち どれを実装するか ］を文書化する必要がある。 ◎ Generic decoders need to document which of these three approaches they implement.

`~map$用の~CBOR~data~modelは、［ `~map$表現における`~entry$の順序 ］に何らかの意味論をあてがうことを許容しない。 したがって，~CBORに基づく~protocolは、［ ある`~map$内で`~entry$たちの順序が変更されたとき，意味論が変化する ］ものと指定してはナラナイ — 一部の順序 （例えば、決定論的な符号化法の要件（ `4.2§ ）を満たさなくなる所など） は許容しないものと指定することを除いて。 （~map順序付けによる副次的な効果 — その時機, ~cache用法, ~side-channelになり得る他のものなど — は、 意味論の一部を成すとは見なされないが，［ ある~protocolが，自前で決定論的な符号化~形式を要求する ］ための十分な理由を成し得る。） ◎ The CBOR data model for maps does not allow ascribing semantics to the order of the key/value pairs in the map representation. Thus, a CBOR-based protocol MUST NOT specify that changing the key/value pair order in a map changes the semantics, except to specify that some orders are disallowed, for example, where they would not meet the requirements of a deterministic encoding (Section 4.2). (Any secondary effects of map ordering such as on timing, cache usage, and other potential side channels are not considered part of the semantics but may be enough reason on their own for a protocol to require a deterministic encoding format.)

拘束された機器~用の応用は、 `~map$に頻繁に利用される`~key$の個数が少ない場合には， `~key$として小さな`~integer$を利用することを考慮するべきである。 一例として、 24 個以下の`~key$は，無符号`~integer$として — 48 個以下の`~key$は，負な`~integer$も利用して — 1 個の~byte内に符号化でき、 さほど頻繁に生じない`~key$には，より長い符号化を伴う`~integer$を利用できる。 ◎ Applications for constrained devices should consider using small integers as keys if they have maps with a small number of frequently used keys; for instance, a set of 24 or fewer keys can be encoded in a single byte as unsigned integers, up to 48 if negative integers are also used. Less frequently occurring keys can then use integers with longer encodings.

5.7. `undefined^i 値

~CBORに基づく一部の~protocolにおいては、 符号化器により`単純~値$ `undefined$i が利用されるかもしれない — ［ 符号化に問題を伴う~data~item用の代用- ］として［ それを封入している~data~itemを成す他の部分に害が及ばないよう符号化する ］ことを許容するために。 ◎ In some CBOR-based protocols, the simple value (Section 3.3) of undefined might be used by an encoder as a substitute for a data item with an encoding problem, in order to allow the rest of the enclosing data items to be encoded without harm.

6.1. ~CBORから~JSONへの変換-法

~JSONは、 ~CBORにおける ほとんどの型に対し，その相似物を直に備える。 しかしながら，一部の型はそうでない — ~CBORから~JSONへの変換器を実装している者は、 それらの事例において何を行うか考慮する必要がある。 以下に挙げる規範的でない助言は、 そのような型を 1 個の代用-値 — ~JSON `null^c など — に変換することにより，これらを処する。 ◎ Most of the types in CBOR have direct analogs in JSON. However, some do not, and someone implementing a CBOR-to-JSON converter has to consider what to do in those cases. The following non-normative advice deals with these by converting them to a single substitute value, such as a JSON null.

• `~integer$（`~major型$ ~IN { `0$mj, `1$mj } ）は、 ~JSON~numberになる。 ◎ An integer (major type 0 or 1) becomes a JSON number.
• `~byte~string$（`~major型$ `2$mj ）のうち［［ ある提案された符号化法を指定する`~tag$ ］内に埋込まれたもの ］でないものは、 ~base64url内に補充~文字を伴わずに符号化され， ~JSON~stringになる ◎ A byte string (major type 2) that is not embedded in a tag that specifies a proposed encoding is encoded in base64url without padding and becomes a JSON string.

• `~UTF-8~string$（`~major型$ `3$mj ）は、 ~JSON~stringになる。 ◎ A UTF-8 string (major type 3) becomes a JSON string.＼

  ~JSONは、 次に挙げる文字に対し，~escape法を要求することに注意 （ `RFC8259$r `§ 7＠~RFCx/rfc8259#section-7$ ） ⇒＃ `0022^U `"^smb（ `QUOTATION MARK^cn ／二重-引用符）, `005C^U `\^smb（ `REVERSE SOLIDUS^cn ）, `0000^U 〜 `001F^U （~C0制御~文字） ◎終 他の文字は、 ~JSON~UTF-8~stringの中へそのまま複製される。 ◎ Note that JSON requires escaping certain characters ([RFC8259], Section 7): quotation mark (U+0022), reverse solidus (U+005C), and the "C0 control characters" (U+0000 through U+001F). All other characters are copied unchanged into the JSON UTF-8 string.

• `~array$（`~major型$ `4$mj ）は、 ~JSON~arrayになる。 ◎ An array (major type 4) becomes a JSON array.

• `~map$（`~major型$ `5$mj ）は、 ~JSON~objectになる。 ◎ A map (major type 5) becomes a JSON object.＼

  これが直にアリになるのは、 すべての`~key$が`~UTF-8~string$である場合に限られる。 変換器は、 他の`~key$も`~UTF-8~string$に変換するかもしれない （`~integer$を［ その~decimal表現を包含している~string ］に変換するなどにより） — しかしながら，そうすることは、 ~key衝突の危険性も導入する。 これはまた、［ `~UTF-8~string$に対する`~tag$が下に提案されるとおり無視される場合 ］には［ 当の`~tag$どうしは異なるが~stringどうしは同じである場合 ］に~key衝突の原因になることにも注意。 ◎ This is possible directly only if all keys are UTF-8 strings. A converter might also convert other keys into UTF-8 strings (such as by converting integers into strings containing their decimal representation); however, doing so introduces a danger of key collision. Note also that, if tags on UTF-8 strings are ignored as proposed below, this will cause a key collision if the tags are different but the strings are the same.

• ［ `単純~値$／`~float$値 ］（`~major型$ `7$mj ）は： ◎ ↓

  • `false$i （`追加l情報$ `20^ai ）は、 ~JSON `false^c になる。 ◎ False (major type 7, additional information 20) becomes a JSON false.
  • `true$i （`追加l情報$ `21^ai ）は、 ~JSON `true^c になる。 ◎ True (major type 7, additional information 21) becomes a JSON true.
  • `null$i （`追加l情報$ `22^ai ）は、 ~JSON `null^c になる。 ◎ Null (major type 7, additional information 22) becomes a JSON null.

  • `~float$値 （ `追加l情報$ ~IN { `25^ai, `26^ai, `27^ai } ）は、 当の値に応じて： ◎ A floating-point value (major type 7, additional information 25 through 27) becomes＼

    • 有限である場合、 ~JSON~numberになる （すなわち，~JSON~numberで表現できる） ◎ a JSON number if it is finite (that is, it can be represented in a JSON number);＼
    • 非-有限である場合 （~NaN ／ 正な~Infinity／負な~Infinity）、 代用-値により表現される。 ◎ if the value is non-finite (NaN, or positive or negative Infinity), it is represented by the substitute value.

  • その他の`単純~値$ （`追加l情報$はまだ論じられていない他の値） は、 代用-値により表現される。

    ◎ Any other simple value (major type 7, any additional information value not yet discussed) is represented by the substitute value.

  【 ［ `単純~値$ `undefined$i ／ 非-有限な`~float$値 ］に対応するものは、 ~JSには在るが，~JSONには無いことに注意。 】

• 各種`~tag$（ `~major型$ `6$mj ）は： ◎ ↓

  • `~bignum$ （ `~tag番号$ ~IN { `2$tag, `3$tag } ）は、［ その`~tag内容$を成す`~byte~string$を補充~文字を伴わない~base64urlに符号化する ］ことにより表現され，~JSON~stringになる。 `~tag番号$ `3$tag （負な`~bignum$）用には， `007E^U `~^smb（~ASCII `tilde^en ）が~base-符号化された値の前に挿入される。 （~numberの代わりに~binary~blobへ変換することで、 ~JSON復号器における数量-~overflowは防止されると見込まれる。） ◎ A bignum (major type 6, tag number 2 or 3) is represented by encoding its byte string in base64url without padding and becomes a JSON string. For tag number 3 (negative bignum), a "~" (ASCII tilde) is inserted before the base-encoded value. (The conversion to a binary blob instead of a number is to prevent a likely numeric overflow for the JSON decoder.)
  • 符号化法~hintを伴う`~byte~string$ （ `~tag番号$ ~IN { `21$tag, `22$tag, `23$tag } ） は、 当の~hintにより述べられるとおりに符号化され， ~JSON~stringになる。【`3.4.5.2§】 ◎ A byte string with an encoding hint (major type 6, tag number 21 through 23) is encoded as described by the hint and becomes a JSON string.
  • 他のすべての`~tag$ （その他の`~tag番号$） 用には、 当の`~tag内容$が~JSON値として表現され，`~tag番号$は無視される。 ◎ For all other tags (major type 6, any other tag number), the tag content is represented as a JSON value; the tag number is ignored.
• `不定長$な~itemは、 変換する前に`確定長$にされる。 ◎ Indefinite-length items are made definite before conversion.

~CBORから~JSONへの変換器は、［ 相互運用能を最大化する ］ため, および［ ~JSON出力を予測-可能な結果で処理できる~~確証を高める ］ために， ~JSON~profile ~I-JSON `RFC7493$r を保つよう求めることもあろう。 これには、 例えば，次に対する含意がある ⇒＃ 依拠-可能に表現できる`~integer$の範囲／ 旧い~JSON実装が~supportし得る~top-level~item ◎ A CBOR-to-JSON converter may want to keep to the JSON profile I-JSON [RFC7493], to maximize interoperability and increase confidence that the JSON output can be processed with predictable results. For example, this has implications on the range of integers that can be represented reliably, as well as on the top-level items that may be supported by older JSON implementations.

6.2. ~JSONから~CBORへの変換-法

すべての~JSON値は、 復号されたなら， 1 個以上の~CBOR値に直に対応付けられる。 ~CBORを生成するときと同じく，~number表現に関して裁定を下す必要がある。 示唆される変換は： ◎ All JSON values, once decoded, directly map into one or more CBOR values. As with any kind of CBOR generation, decisions have to be made with respect to number representation. In a suggested conversion:

• 小数部を伴わない~JSON~number（~integer~number）は、［ `~integer$ （`~major型$ ~IN { `0$mj, `1$mj } ） あるいは，場合によっては`~bignum$ （ `~major型$ `6$mj, `~tag番号$ ~IN { `2$tag, `3$tag } ） ］として，最短な形を選んで表現される — `~integer$のうち，実装~定義な~~上限より長いものは、 代わりに，`~float$値として表現され得る。 `~integer$として表現される既定の範囲は、 { −2`53^sup ~PLUS 1 〜 2`53^sup ~MINUS 1 } である （これは、 ~JSONを復号するときによく利用される，［ `倍-精度~float$表現における正確な~integer ］用の範囲 `RFC7493$r を全部的に活かす）。 ［ ~CBORに基づく~protocol／ 汎用な変換器の実装 ］は、 次のどちらを選ぶこともある： ◎ JSON numbers without fractional parts (integer numbers) are represented as integers (major types 0 and 1, possibly major type 6, tag number 2 and 3), choosing the shortest form; integers longer than an implementation-defined threshold may instead be represented as floating-point values. The default range that is represented as integer is -253+1..253-1 (fully exploiting the range for exact integers in the binary64 representation often used for decoding JSON [RFC7493]). A CBOR-based protocol, or a generic converter implementation, may choose＼

  • { −2`32^sup 〜 2`32^sup ~MINUS 1 } および { −2`64^sup 〜 2`64^sup ~MINUS 1 } （~CBORにおいて［ ~uint32_t ／ ~uint64_t ］で可用な~integer範囲を全部的に利用する） ◎ -232..232-1 or -264..264-1 (fully using the integer ranges available in CBOR with uint32_t or uint64_t, respectively)＼
  • 【！or even】 { −2`31^sup 〜 2`31^sup ~MINUS 1 } および { −2`63^sup 〜 2`63^sup ~MINUS 1 } （［ 2 の補数による有符号`~integer$ ］用に普及している範囲を利用する） ◎ or even -231..231-1 or -263..263-1 (using popular ranges for two's complement signed integers).＼

  （当の~JSONが，ある~JS実装から生成されたものである場合、 その精度は，すでに最大 53 ~bitまでに制限される。） ◎ (If the JSON was generated from a JavaScript implementation, its precision is already limited to 53 bits maximum.)

• 小数部を伴う~numberは、 `~float$値として表現される — ［ `倍-精度~float$により供される精度 ］に基づく，~decimalから~binaryへの変換を遂行することにより。 ［ ~JSON~numberの `the mathematical value^en ］は、［ `IEEE754$r § 4.3.1 における `roundTiesToEven^en 手続- ］を利用して，`倍-精度~float$へ変換される。 この変換~結果を~CBOR内に符号化するときに選好される直列化は、 それを正確に表現している最短な`~float$表現を利用する — 一例として， 1.5 は、 `半-精度~float$値で表現される （最小な形を効率的に見出す能力が無い実装もあるが）。 この変換は、既定の`倍-精度~float$の精度を利用する代わりに，［ 表現される値の精度に影響する，実装~定義な精度 ］に制限され得る。 ~CBOR側において~decimal表現を利用するのは、 ~protocolにおいて，そう指定された場合に限るべきである。 ◎ Numbers with fractional parts are represented as floating-point values, performing the decimal-to-binary conversion based on the precision provided by IEEE 754 binary64. The mathematical value of the JSON number is converted to binary64 using the roundTiesToEven procedure in Section 4.3.1 of [IEEE754]. Then, when encoding in CBOR, the preferred serialization uses the shortest floating-point representation exactly representing this conversion result; for instance, 1.5 is represented in a 16-bit floating-point value (not all implementations will be capable of efficiently finding the minimum form, though). Instead of using the default binary64 precision, there may be an implementation-defined limit to the precision of the conversion that will affect the precision of the represented values. Decimal representation should only be used on the CBOR side if that is specified in a protocol.

~CBORは、 一般に［ ~JSONより~compactな符号化法 ］を供するよう設計された。 思い浮かぶであろう実装~策の一つは、 単独の~buffer内で, その場で，~JSONから~CBORへの符号化を遂行することである。 この策は、 いくつかの病的な事例を注意深く考慮する必要がある — ~stringのうち［ ~escapeは ごく少数に限られ， 255 ~byteより長く（または ずっと長く）表現されるもの ］のうち一部は、 ~CBOR内で`~UTF-8~string$として符号化するとき展開され得るなど 【この事例の どこが “病的” とされるのかよくわからない】。 類似に，~binary`~float$表現のうち少数のものは、 ~JSONにおける何らかの短い~decimal表現（例： 1.1, 1e9 ）からの展開をもたらすかもしれない。 これを~~正しく行うのは難しいこともあり、 それによる脆弱性は，攻撃者により悪用されよう。 ◎ CBOR has been designed to generally provide a more compact encoding than JSON. One implementation strategy that might come to mind is to perform a JSON-to-CBOR encoding in place in a single buffer. This strategy would need to carefully consider a number of pathological cases, such as that some strings represented with no or very few escapes and longer (or much longer) than 255 bytes may expand when encoded as UTF-8 strings in CBOR. Similarly, a few of the binary floating-point representations might cause expansion from some short decimal representations (1.1, 1e9) in JSON. This may be hard to get right, and any ensuing vulnerabilities may be exploited by an attacker.

7.1. 拡張~地点

~protocol設計においては、 発展~用の機会は，拡張~地点の形で含まれることが多い。 例えば，ある符号点~空間は、 初めから全部的に割振られてはおらず， 当の~protocolは［ 初期~時には割振られてはいなかった符号点を，初めから利用する実装 ］を追認できるように設計されることもあろう。 ◎ In a protocol design, opportunities for evolution are often included in the form of extension points. For example, there may be a codepoint space that is not fully allocated from the outset, and the protocol is designed to tolerate and embrace implementations that start using more codepoints than initially allocated.

符号点~空間の~sizingは、 困難なこともある — その範囲を予測するのは難しいこともあるので。 ~protocol設計は、［ ~protocolに意図される存続期間の中で、 当の符号点~空間が簡単に埋め尽くされない ］よう，十分~大きくとるよう試みるべきである。 ◎ Sizing the codepoint space may be difficult because the range required may be hard to predict. Protocol designs should attempt to make the codepoint space large enough so that it can slowly be filled over the intended lifetime of the protocol.

~CBORには、 主要な拡張~地点として，次に挙げる 3 種がある： ◎ CBOR has three major extension points:

`単純~値$用の空間（`~major型$ `7$mj 内の値） ◎ the "simple" space (values in major type 7):

小さな~numberに限って割振られた， 24 個の効率的な（および 224 個の少しだけ効率的でない）値。 その値の構造は，~~実際に単純なので、 実装は，受信した単純~data~itemが未知であっても容易に処理できよう。 ［ `9.1§ における~IANA~registry ］が［ この符号点~空間の拡張能に取組むための適切な仕方 ］になる。 ◎ Of the 24 efficient (and 224 slightly less efficient) values, only a small number have been allocated. Implementations receiving an unknown simple data item may easily be able to process it as such, given that the structure of the value is indeed simple. The IANA registry in Section 9.1 is the appropriate way to address the extensibility of this codepoint space.

`~tag$用の空間（`~major型$ `6$mj 内の値） ◎ the "tag" space (values in major type 6):

符号点~空間の総量は膨大であり、 割振られた符号点は僅かしかない。 しかしながら，［ これらの符号点~すべてが等しく効率的 ］ではない： 最初の 24 個は、 1 個の~byte（先頭~byteのみ）しか消費しない — うち半分は，すでに割振られている。 その次の 232 個の値は、 2 個の~byte（先頭~byte + 1 ~byte）しか消費しない — うち およそ 4 分の 1 は，すでに割振られている。 これらの下位-空間は、 あと何十年かは残り続けるよう，何らかの精選が必要である。 未知な`~tag番号$を受信している実装は、［ 封入された`~tag内容$だけを処理する ］か［ 当の`~tag$を［ その`~tag内容$を包装している未知な`~tag番号$ ］として処理する ］かを選べる — 後者が好ましいが。 ［ `9.2§ における~IANA~registry ］が［ この符号点~空間の拡張能に取組むための適切な仕方 ］になる。 ◎ The total codepoint space is abundant; only a tiny part of it has been allocated. However, not all of these codepoints are equally efficient: the first 24 only consume a single ("1+0") byte, and half of them have already been allocated. The next 232 values only consume two ("1+1") bytes, with nearly a quarter already allocated. These subspaces need some curation to last for a few more decades. Implementations receiving an unknown tag number can choose to process just the enclosed tag content or, preferably, to process the tag as an unknown tag number wrapping the tag content. The IANA registry in Section 9.2 is the appropriate way to address the extensibility of this codepoint space.

`追加l情報$用の空間 ◎ the "additional information" space:

追加l情報として未知な値を受信している実装には，復号を継続する仕方は無いので、 この空間~内に符号点を割振ることは，［ 拡張~地点を行使するだけに過ぎないもの ］を超える主要な段になる。 また、 残された符号点は，ごく少数しかない。 `7.2§ も見よ。 ◎ An implementation receiving an unknown additional information value has no way to continue decoding, so allocating codepoints in this space is a major step beyond just exercising an extension point. There are also very few codepoints left. See also Section 7.2.

7.2. 追加l情報~用の空間の精選-法

ヒトはときには、 小さな “隙間” を知覚したとき，そこを埋めて白黒つけたがる。 `追加l情報$用の符号点~空間に残された値の隙間は、 その~~存在自体が新たな案を引き寄せるものになると予期される。 ◎ The human mind is sometimes drawn to filling in little perceived gaps to make something neat. We expect the remaining gaps in the codepoint space for the additional information values to be an attractor for new ideas, just because they are there.

~CBORの現~versionは、 追加l情報~用の符号点~空間を~IANA~registryにより管理しない — この空間の割振りを行い得るのは、 この仕様を更新することに限られる。 ◎ The present specification does not manage the additional information codepoint space by an IANA registry. Instead, allocations out of this space can only be done by updating this specification.

`追加l情報$値 %n ~IN { `24^ai, `25^ai, `26^ai, `27^ai } の場合、 追加的な~dataの~sizeは 2<sup>%n ~MINUS 24</sup> ~byteになる。 したがって、 `追加l情報$値［ `28^ai ／ `29^ai ］も，~CBOR~protocolに それらを追加する必要が発生する事例では［ 128 ~bit ／ 256 ~bit ］~size用の候補と見るべきである。 一般的な割振り用に可用な`追加l情報$値は `30^ai のみであり、 特段に良い理由が無い限り，［ ~CBORの現~versionの更新を通してアテガう前 ］に割振るべきではない。 ◎ For an additional information value of n >= 24, the size of the additional data typically is 2n-24 bytes. Therefore, additional information values 28 and 29 should be viewed as candidates for 128-bit and 256-bit quantities, in case a need arises to add them to the protocol. Additional information value 30 is then the only additional information value available for general allocation, and there should be a very good reason for allocating it before assigning it through an update of the present specification.

8.1. 符号化法~指示子

ときには、［ いくつかある代替な表現のうち どれが実際に利用されたか ］を［ 診断用の記法により指示する ］ことが有用になることもある — 例えば， 診断用の復号器により `1.5^dg と書かれた ある~data~itemは、［ `半-精度$／`単-精度$／`倍-精度$ ］のうち どの`~float$として符号化されたものか~~判別できない。 ◎ Sometimes it is useful to indicate in the diagnostic notation which of several alternative representations were actually used; for example, a data item written >1.5< by a diagnostic decoder might have been encoded as a half-, single-, or double-precision float.

規約として、［［ 英数字, ~underscore ］のみからなり，最初の文字は~underscoreである文字~並び ］ — 例： `_^dg ／ `_3^dg — は，符号化法の指示子を成す — この情報に関心がない者は、 それらを無視できる。 符号化法~指示子は、 常に省略可能である。 ◎ The convention for encoding indicators is that anything starting with an underscore and all following characters that are alphanumeric or underscore is an encoding indicator, and can be ignored by anyone not interested in this information. For example, _ or _3. Encoding indicators are always optional.

［ ~data~itemが`不定長$な形式で表現されたこと ］を指示するためとして、［ `~map$の左~波括弧／`~array$の左~角括弧 ］の後に 1 個の~underscoreを書ける。 例えば， `[_ 1, 2s]^dg は、［ `不定長$な表現が，~data~item [1, 2] を表現するために利用された ］ことを指示する。 ◎ A single underscore can be written after the opening brace of a map or the opening bracket of an array to indicate that the data item was represented in indefinite-length format. For example, [_ 1, 2] contains an indicator that an indefinite-length representation was used to represent the data item [1, 2].

［ ~underscoreのうち，数字 %n が後続するもの ］は、［ 先行している~item （あるいは、［ `~array$／`~map$ ］用には，先行している［ 角括弧／波括弧 ］で開始している~item） は、 `追加l情報$の値 ( 24 ~PLUS %n ) を伴って符号化されたこと ］を指示する。 例えば， `1.5_1^dg は`半-精度~float$である一方、 `1.5_3^dg は`倍-精度~float$として符号化されたものである。 この符号化法~指示子は、 `A§ においては示されない。 （したがって、 符号化法~指示子 `_^dg は全部的な形 `_7^dg の略語であり【なぜ？】，利用されないことに注意。） ◎ An underscore followed by a decimal digit n indicates that the preceding item (or, for arrays and maps, the item starting with the preceding bracket or brace) was encoded with an additional information value of 24+n. For example, 1.5_1 is a half-precision floating-point number, while 1.5_3 is encoded as double precision. This encoding indicator is not shown in Appendix A. (Note that the encoding indicator "_" is thus an abbreviation of the full form "_7", which is not used.)

`不定長$な［ `~byte~string$／`~text~string$ ］を成す~chunk構造の詳細は、［ `(_ h'0123', h'4567')^dg ／ `(_ "foo", "bar")^dg ］の形で記せる。 しかしながら，`不定長$な~stringが 0 個の~chunkからなる場合、 `(_ )^dg は［ `~byte~string$（ `5fff^X ）／`~text~string$（ `7fff^X ） ］どちらが意味されるのか多義的になるので， この形は利用されない — 代わりに，［ ~chunkが無い事例~用に限るものとして予約される基本的な形 ］［ `''_^dg ／ `""_^dg ］を利用できる。 これは、［ 空な（許可されるが，本当に有用ではない）~chunkたち のみからなる符号化 ］用の短い形ではない — そのような符号化は、 当の~chunk構造を保全するよう，［ `(_ '')^dg ／ `(_ "")^dg ］, 等々として記される必要がある。 ◎ The detailed chunk structure of byte and text strings of indefinite length can be notated in the form (_ h'0123', h'4567') and (_ "foo", "bar"). However, for an indefinite-length string with no chunks inside, (_ ) would be ambiguous as to whether a byte string (0x5fff) or a text string (0x7fff) is meant and is therefore not used. The basic forms ''_ and ""_ can be used instead and are reserved for the case of no chunks only -- not as short forms for the (permitted, but not really useful) encodings with only empty chunks, which need to be notated as (_ ''), (_ ""), etc., to preserve the chunk structure.