CharsetDecoder 类

定义

[Android.Runtime.Register("java/nio/charset/CharsetDecoder", DoNotGenerateAcw=true)]
public abstract class CharsetDecoder : Java.Lang.Object

[<Android.Runtime.Register("java/nio/charset/CharsetDecoder", DoNotGenerateAcw=true)>]
type CharsetDecoder = class
    inherit Object

继承

Object

Object

CharsetDecoder

属性

RegisterAttribute

注解

可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。

“steps”>

输入字节序列在字节缓冲区或一系列此类缓冲区中提供。 输出字符序列将写入字符缓冲区或一系列此类缓冲区。 应始终使用以下方法调用序列（以下简称 解码操作）来使用解码器：

<ol>

<li>

通过 #reset reset 方法重置解码器，除非之前未使用解码器;

</li>

<li>

#decode decode调用方法零次或多次，只要其他输入可用，为endOfInput参数传递false并填充输入缓冲区并在调用之间刷新输出缓冲区：

</li>

<li>

#decode decode调用方法一次最后一次，为参数传递endOfInputtrue;然后

</li>

<li>

#flush flush调用该方法，以便解码器可以将任何内部状态刷新到输出缓冲区。

</li>

</ol>

该方法的每个调用 #decode decode 都将从输入缓冲区解码尽可能多的字节，并将生成的字符写入输出缓冲区。 当需要更多输入、输出缓冲区中没有足够的空间或出现解码错误时，该方法 #decode decode 将返回。 在每种情况下，都会返回一个 CoderResult 对象来描述终止的原因。 调用程序可以检查此对象并填充输入缓冲区、刷新输出缓冲区或尝试根据解码错误进行恢复，然后重试。

“ce”>

有两种常规类型的解码错误。 如果此字符集的输入字节序列不合法，则输入被视为 格式不正确。 如果输入字节序列是合法的，但无法映射到有效的 Unicode 字符，则遇到 不可应用的字符 。

“cae”>

如何处理解码错误取决于为该类型的错误请求的操作，该操作由类的 CodingErrorAction 实例描述。 可能的错误操作是 CodeErrorAction#IGNORE 忽略错误输入，CodeErrorAction#REPORT 通过返回 CoderResult 的对象向调用方报告错误，或者 CodeErrorAction#REPLACE 将错误输入替换为替换字符串的当前值。 替换项

具有初始值 "\uFFFD";

可以通过该方法更改 #replaceWith(java.lang.String) replaceWith 其值。

格式不正确的输入和不可应用字符错误的默认操作是 CodeErrorAction#REPORT 报告错误。 错误输入错误操作可以通过该方法更改 #onMalformedInput(CodingErrorAction) onMalformedInput ;不可应用字符操作可以通过该方法更改 #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter 。

此类旨在处理解码过程的许多详细信息，包括错误操作的实现。 特定字符集（此类的具体子类）的解码器只需要实现抽象 #decodeLoop decodeLoop 方法，该方法封装基本解码循环。 维护内部状态的子类应重写 #implFlush implFlush 和 #implReset implReset 方法。

此类的实例不适用于多个并发线程使用。

在 1.4 中添加。

Java文档java.nio.charset.CharsetDecoder。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。