CharsetDecoder 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。
[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
- 继承
- 属性
注解
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。
“步骤”>
输入字节序列在字节缓冲区或一系列此类缓冲区中提供。 输出字符序列将写入字符缓冲区或一系列此类缓冲区。 应始终通过进行以下方法调用序列(以下称为 解码操作)来使用解码器:
<老>
<李>
通过 #reset reset
方法重置解码器,除非以前未使用过;
</李>
<李>
#decode decode
调用 方法零次或多次,只要其他输入可用,传递false
参数endOfInput
并填充输入缓冲区并在调用之间刷新输出缓冲区;
</李>
<李>
#decode decode
最后调用方法一次,为 endOfInput
参数传递true
;然后
</李>
<李>
#flush flush
调用 方法,以便解码器可以将任何内部状态刷新到输出缓冲区。
</李>
</老>
每次调用 #decode decode
方法都会从输入缓冲区解码尽可能多的字节,并将生成的字符写入输出缓冲区。 #decode decode
当需要更多输入、输出缓冲区中没有足够的空间或发生解码错误时,方法将返回 。 在每种情况下,都会返回一个 CoderResult
对象来描述终止的原因。 调用程序可以检查此对象并填充输入缓冲区、刷新输出缓冲区,或者尝试根据需要从解码错误中恢复,然后重试。
“ce”>
有两种常规类型的解码错误。 如果输入字节序列对于此字符集不合法,则认为输入 格式不正确。 如果输入字节序列合法,但无法映射到有效的 Unicode 字符,则遇到 不可应用字符 。
“cae”>
如何处理解码错误取决于针对该错误类型请求的操作,该操作由 类的 CodingErrorAction
实例描述。 可能的错误操作包括对 CodingErrorAction#IGNORE 忽略错误输入、CodingErrorAction#REPORT 通过返回 CoderResult
的对象向调用方报告错误,或将错误输入替换为替换字符串的当前值。 替换
具有初始值 "\uFFFD"
;
其值可以通过 方法更改 #replaceWith(java.lang.String) replaceWith
。
输入格式错误和不可应用字符错误的默认操作是向 CodingErrorAction#REPORT 报告它们。 格式错误的输入错误操作可以通过 方法更改 #onMalformedInput(CodingErrorAction) onMalformedInput
;不可应用字符操作可以通过 方法更改 #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter
。
此类旨在处理解码过程的许多详细信息,包括错误操作的实现。 特定字符集(此类的具体子类)的解码器只需实现抽象 #decodeLoop decodeLoop
方法,它封装基本解码循环。 此外,维护内部状态的子类应重写 #implFlush implFlush
和 #implReset implReset
方法。
此类的实例对于多个并发线程使用是不安全的。
在 1.4 中添加。
的 java.nio.charset.CharsetDecoder
Java 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改,并根据 署名许可中所述的术语使用。
构造函数
CharsetDecoder(Charset, Single, Single) |
初始化新的解码器。 |
CharsetDecoder(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
Class |
返回此 |
Handle |
基础 Android 实例的句柄。 (继承自 Object) |
IsAutoDetecting |
指示此解码器是否实现自动检测字符集。 |
IsCharsetDetected |
指示此解码器是否已检测到字符集 (可选操作) 。 |
JniIdentityHashCode |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
JniPeerMembers |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 |
PeerReference |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
ThresholdClass |
此 API 支持 Mono for Android 基础结构,不应直接从代码使用。 |
ThresholdType |
此 API 支持 Mono for Android 基础结构,不应直接从代码使用。 |
方法
AverageCharsPerByte() |
返回将为每个输入字节生成的平均字符数。 |
Charset() |
返回创建此解码器的字符集。 |
Clone() |
创建并返回此对象的副本。 (继承自 Object) |
Decode(ByteBuffer) |
将单个输入字节缓冲区的剩余内容解码为新分配的字符缓冲区的便利方法。 |
Decode(ByteBuffer, CharBuffer, Boolean) |
从给定的输入缓冲区中解码尽可能多的字节,将结果写入给定的输出缓冲区。 |
DecodeLoop(ByteBuffer, CharBuffer) |
将一个或多个字节解码为一个或多个字符。 |
DetectedCharset() |
检索此解码器检测到的字符集 (可选操作) 。 |
Dispose() |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
Dispose(Boolean) |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
Equals(Object) |
指示其他某个对象是否“等于”此对象。 (继承自 Object) |
Flush(CharBuffer) |
刷新此解码器。 |
GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
ImplFlush(CharBuffer) |
刷新此解码器。 |
ImplOnMalformedInput(CodingErrorAction) |
报告对此解码器格式错误的输入操作的更改。 |
ImplOnUnmappableCharacter(CodingErrorAction) |
报告对此解码器的不可应用字符操作的更改。 |
ImplReplaceWith(String) |
报告对此解码器的替换值所做的更改。 |
ImplReset() |
重置此解码器,清除任何特定于字符集的内部状态。 |
JavaFinalize() |
当垃圾回收确定不再引用对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
MalformedInputAction() |
针对格式错误的输入错误返回此解码器的当前操作。 |
MaxCharsPerByte() |
返回将为每个输入字节生成的最大字符数。 |
Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
OnMalformedInput(CodingErrorAction) |
更改此解码器针对格式错误的输入错误的操作。 |
OnUnmappableCharacter(CodingErrorAction) |
更改此解码器针对不可应用字符错误的操作。 |
Replacement() |
返回此解码器的替换值。 |
ReplaceWith(String) |
更改此解码器的替换值。 |
Reset() |
重置此解码器,清除任何内部状态。 |
SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
ToArray<T>() |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
UnmappableCharacterAction() |
返回此解码器针对不可应用字符错误的当前操作。 |
UnregisterFromRuntime() |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
Wait() |
导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>。<> (继承自 Object) |
Wait(Int64) |
导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>,或直到经过一定数量的实时。<> (继承自 Object) |
Wait(Int64, Int32) |
导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>,或直到经过一定数量的实时。<> (继承自 Object) |
显式接口实现
IJavaPeerable.Disposed() |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
IJavaPeerable.DisposeUnlessReferenced() |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
IJavaPeerable.Finalized() |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
IJavaPeerable.JniManagedPeerState |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 (继承自 Object) |
扩展方法
JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
JavaCast<TResult>(IJavaObject) |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 |
GetJniTypeName(IJavaPeerable) |
可将特定字符集中的字节序列转换为 16 位 Unicode 字符序列的引擎。 |