编码

要从 I/O 队列 ioQueue 读取一个 项，按以下步骤执行：

1. 如果 ioQueue 为空，则等待直到其 长度 至少为 1。

2. 如果 ioQueue[0] 是 队列结尾（end-of-queue），则返回 队列结尾。

3. 移除 ioQueue[0] 并返回它。

要从 ioQueue 中读取 number 个 项，请执行以下步骤：

1. 令 readItems 为 « »。

2. 执行以下步骤 number 次：

   1. 追加到 readItems，结果为从 ioQueue 读取的一个项。

3. 移除 队列末尾 从 readItems。

4. 返回 readItems。

要从 I/O 队列 ioQueue 窥视（peek） number 个 项，按以下步骤执行：

1. 等待，直到 ioQueue 的 长度等于或大于 number，或 ioQueue包含 队列结尾（end-of-queue），以先发生者为准。

2. 令 prefix 为 « »。

3. 对于 区间 1 到 number（含），中的每个 n：

   1. 如果 ioQueue[n] 是 队列结尾，则 跳出循环。

   2. 否则，将 ioQueue[n] 追加到 prefix。

4. 返回 prefix。

要向 I/O 队列 ioQueue 推送一个 项 item，按以下步骤执行：

1. 如果 ioQueue 的最后一个 项为 队列结尾（end-of-queue）：

   1. 如果 item 也是 队列结尾，则不做任何操作。

   2. 否则，在 ioQueue 的最后一个 项之前插入 item。

2. 否则，将 item 追加到 ioQueue。

向 I/O 队列 ioQueue 推送一系列项，是指按照给定顺序，将序列中的每一项依次推送到 ioQueue 中。

将一个 项（非 队列结尾（end-of-queue））恢复到 I/O 队列中，即执行 列表的 前插（prepend）操作。将一个不含 队列结尾 的项列表恢复到 I/O 队列中，则按给定顺序将这些项插入到队列的第一个项之前。

要转换一个 I/O 队列 ioQueue 为列表、字符串或字节序列，返回从 ioQueue 读取无限数量项的结果。

要转换一个列表、字符串或字节序列 input 为 I/O 队列，按照以下步骤操作：

1. 断言：input 不是 列表，或者其中不包含 队列结尾。

2. 返回一个 I/O 队列，其内容为 input 中的项（按顺序），并在末尾加上 队列结尾。

要从代理对中获取一个 标量值，给定一个 前导代理 leading 和一个 尾随代理 trailing，返回 0x10000 + ((leading − 0xD800) << 10) + (trailing − 0xDC00)。

要创建一个 Uint8Array 对象，给定一个 I/O 队列 ioQueue 和 realm realm：

1. 令 bytes 为将 ioQueue 转换为字节序列的结果。

2. 返回在 realm 中用 bytes 创建 Uint8Array 对象的结果。

要处理队列，给定一个编码的解码器或编码器实例encoderDecoder、I/O 队列input、I/O 队列output和错误模式mode：

1. 当条件为真时：

   1. 令result为通过以下步骤处理一个项的结果：从input读取、encoderDecoder、input、output和mode。

   2. 如果result不是继续，则返回result。

要处理一个项，给定一个项item、一个编码的编码器或解码器实例encoderDecoder、I/O 队列input、I/O 队列output和错误模式mode：

1. 断言：encoderDecoder不是一个编码器实例或mode不是"replacement"。

2. 断言：encoderDecoder不是一个解码器实例或mode不是"html"。

3. 断言：encoderDecoder不是一个编码器实例或item不是一个代理。

4. 令result为运行encoderDecoder的处理器算法，输入为input和item的结果。

5. 如果result是完成：

   1. 推入队列末尾到output。

   2. 返回result。

6. 否则，如果result是一个或多个项：

   1. 断言：encoderDecoder不是一个解码器实例或result不包含任何代理。

   2. 推入result到output。

7. 否则，如果result是一个错误，根据mode运行相关步骤：

   "replacement"

   推入U+FFFD (�)到output。

   "html"

   推入0x26 (&), 0x23 (#)，后跟表示result的代码点值的最短十进制序列（范围为0x30 (0)到0x39 (9)，含），最后是0x3B (;)到output。

   "fatal"

   返回result。

8. 返回继续。

要从字符串label获取编码，请执行以下步骤：

1. 移除label中的任何前导和尾随ASCII 空白。

2. 如果label与下表中列出的任何标签ASCII 大小写不敏感匹配，则返回对应的编码；否则返回失败。

GB18030 范围索引代码点是针对pointer的以下步骤的返回值：

1. 如果pointer大于 39419 且小于 189000，或者pointer大于 1237575，则返回 null。

2. 如果pointer是 7457，则返回代码点 U+E7C7。

3. 令offset为GB18030 范围索引中小于或等于pointer的最后一个指针，并令codePointOffset为其对应的代码点。

4. 返回一个代码点，其值为codePointOffset + pointer − offset。

GB18030 范围索引指针是针对codePoint的以下步骤的返回值：

1. 如果codePoint是 U+E7C7，则返回指针 7457。

2. 令offset为GB18030 范围索引中小于或等于codePoint的最后一个代码点，并令pointerOffset为其对应的指针。

3. 返回一个指针，其值为pointerOffset + codePoint − offset。

Shift_JIS 索引指针是针对codePoint的以下步骤的返回值：

1. 令index为JIS0208 索引，排除所有指针在 8272 到 8835（含）范围内的条目。

   JIS0208 索引包含重复的代码点，因此排除这些条目会导致使用后面的代码点。

2. 返回index中codePoint的索引指针。

Big5 索引指针是针对codePoint的以下步骤的返回值：

1. 令index为Big5 索引，排除所有指针小于 (0xA1 - 0x81) × 157 的条目。

   避免直接返回香港增补字符集扩展。

2. 如果codePoint是 U+2550 (═)、U+255E (╞)、U+2561 (╡)、U+256A (╪)、U+5341 (十) 或 U+5345 (卅)，则返回index中与codePoint对应的最后一个指针。

   还有其他重复的代码点，但对于那些代码点，应使用第一个指针。

3. 返回index中codePoint的索引指针。

要对字节的 I/O 队列ioQueue进行UTF-8 解码，给定一个可选的标量值 I/O 队列output（默认为 « »），请执行以下步骤：

1. 令buffer为从ioQueue窥视三个字节并转换为字节序列的结果。

2. 如果buffer是 0xEF 0xBB 0xBF，则从ioQueue读取三个字节。（不对这些字节执行任何操作。）

3. 使用UTF-8的解码器实例、ioQueue、output和"replacement"处理队列。

4. 返回output。

要对字节的 I/O 队列ioQueue进行不带 BOM 的 UTF-8 解码，给定一个可选的标量值 I/O 队列output（默认为 « »），请执行以下步骤：

1. 使用UTF-8的解码器实例、ioQueue、output和"replacement"处理队列。

2. 返回output。

要对字节的 I/O 队列ioQueue进行不带 BOM 或失败的 UTF-8 解码，给定一个可选的标量值 I/O 队列output（默认为 « »），请执行以下步骤：

1. 令potentialError为使用UTF-8的解码器实例、ioQueue、output和"fatal"处理队列的结果。

2. 如果potentialError是一个错误，则返回失败。

3. 返回output。

要对标量值的 I/O 队列ioQueue进行UTF-8 编码，给定一个可选的字节 I/O 队列output（默认为 « »），返回使用UTF-8编码和output编码ioQueue的结果。

要对字节的 I/O 队列ioQueue进行解码，给定一个备用编码encoding和一个可选的标量值 I/O 队列output（默认为 « »），请执行以下步骤：

1. 令BOMEncoding为对ioQueue进行BOM 嗅探的结果。

2. 如果BOMEncoding不为 null：

   1. 将encoding设置为BOMEncoding。

   2. 如果BOMEncoding是UTF-8，则从ioQueue读取三个字节；否则读取两个字节。（不对这些字节执行任何操作。）

   为了与已部署内容兼容，字节顺序标记比任何其他东西都更具权威性。在使用 HTTP 的上下文中，这违反了 `Content-Type` 标头的语义。

3. 使用encoding的解码器实例、ioQueue、output和"replacement"处理队列。

4. 返回output。

要对字节的 I/O 队列ioQueue进行BOM 嗅探，请执行以下步骤：

1. 令BOM为从ioQueue窥视 3 个字节并转换为字节序列的结果。

2. 对于下表中的每一行，从第一行开始向下，如果BOM以第一列中给出的字节开头，则返回该行第二列单元格中给出的编码。否则，返回 null。

   字节顺序标记	编码
   0xEF 0xBB 0xBF	UTF-8
   0xFE 0xFF	UTF-16BE
   0xFF 0xFE	UTF-16LE

此挂钩是一个变通方法，因为解码无法向调用者传达它已找到字节顺序标记，因此未使用提供的编码。此挂钩应在解码之前调用，它将返回与找到的字节顺序标记对应的编码，否则返回 null。

要对标量值的 I/O 队列ioQueue进行编码，给定一个编码encoding和一个可选的字节 I/O 队列output（默认为 « »），请执行以下步骤：

1. 令encoder为从encoding获取编码器的结果。

2. 使用encoder、ioQueue、output和"html"处理队列。

3. 返回output。

这是 HTML 表单的旧版挂钩。在其上层叠UTF-8 编码是安全的，因为它从不触发错误。[HTML]

要从编码encoding获取编码器：

1. 断言：encoding不是替代或UTF-16BE/LE。

2. 返回encoding的编码器实例。

要对标量值的 I/O 队列ioQueue进行编码或失败，给定一个编码器实例encoder和一个字节 I/O 队列output，请执行以下步骤：

1. 令potentialError为使用encoder、ioQueue、output和"fatal"处理队列的结果。

2. 将队列末尾推入output。

3. 如果potentialError是一个错误，则返回错误的代码点的值。

4. 返回 null。

序列化 I/O 队列算法，给定一个 TextDecoderCommon decoder 和一个标量值的I/O 队列 ioQueue，运行以下步骤：

1. 令 output 为空字符串。

2. 当为真时：

   1. 令 item 为从 ioQueue 读取的结果。

   2. 如果 item 是队列末尾，则返回 output。

   3. 如果 decoder 的编码是UTF-8或UTF-16BE/LE，并且 decoder 的忽略 BOM和已见 BOM均为 false：

      1. 将 decoder 的已见 BOM设置为 true。

      2. 如果 item 是 U+FEFF BOM，则继续。

   4. 将 item 附加到 output。

该算法在 BOM 处理方面与平台其余部分使用的解码算法故意不同，以便为 API 用户提供更多控制。

encoding getter 的步骤是返回this的编码的名称，并ASCII 小写化。

fatal getter 的步骤是：如果this的错误模式是 "fatal"，则返回 true；否则返回 false。

ignoreBOM getter 的步骤是返回this的忽略 BOM。