语言

CharsetEncoder 类

定义

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

[Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)]
public abstract class CharsetEncoder : Java.Lang.Object
[<Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)>]
type CharsetEncoder = class
    inherit Object
继承
CharsetEncoder
特性

注解

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

“steps”>

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

<ol>

<li>

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

</li>

<li>

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

</li>

<li>

#encode encode调用方法一次最后一次,为参数传递trueendOfInput;然后

</li>

<li>

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

</li>

</ol>

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

“ce”>

编码错误有两种常规类型。 如果输入字符序列不是合法的 16 位 Unicode 序列,则输入被视为 格式不正确。 如果输入字符序列是合法的,但不能映射到给定字符集中的有效字节序列,则遇到 不可应用字符 。

“cae”>

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

最初设置为编码器的默认替换,通常(但不总是)具有初始值 { (byte)'?' };

可以通过该方法更改 #replaceWith(byte[]) replaceWith 其值。

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

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

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

在 1.4 中添加。

Java文档java.nio.charset.CharsetEncoder。

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

构造函数

名称 说明
CharsetEncoder(Charset, Single, Single, Byte[])

初始化新的编码器。

CharsetEncoder(Charset, Single, Single)

初始化新的编码器。

CharsetEncoder(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于调用此Java对等方成员的 JNI 元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

方法

名称 说明
AverageBytesPerChar()

返回将为每个输入字符生成的平均字节数。

CanEncode(Char)

指示此编码器是否可以对给定字符进行编码。

CanEncode(ICharSequence)

指示此编码器是否可以对给定字符序列进行编码。

CanEncode(String)

指示此编码器是否可以对给定字符序列进行编码。

Charset()

返回创建此编码器的字符集。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Encode(CharBuffer, ByteBuffer, Boolean)

从给定输入缓冲区对任意数量的字符进行编码,并将结果写入给定的输出缓冲区。

Encode(CharBuffer)

将单个输入字符缓冲区的剩余内容编码为新分配的字节缓冲区的便利方法。

EncodeLoop(CharBuffer, ByteBuffer)

将一个或多个字符编码为一个或多个字节。

Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
Flush(ByteBuffer)

刷新此编码器。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
ImplFlush(ByteBuffer)

刷新此编码器。

ImplOnMalformedInput(CodingErrorAction)

报告此编码器格式不正确的输入操作的更改。

ImplOnUnmappableCharacter(CodingErrorAction)

报告此编码器不可应用字符操作的更改。

ImplReplaceWith(Byte[])

报告此编码器的替换值的更改。

ImplReset()

重置此编码器,清除任何特定于字符集的内部状态。

IsLegalReplacement(Byte[])

指示给定字节数组是否是此编码器的法律替换值。

JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
MalformedInputAction()

返回此编码器的当前操作,以显示格式不正确的输入错误。

MaxBytesPerChar()

返回将为每个输入字符生成的最大字节数。

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
OnMalformedInput(CodingErrorAction)

更改此编码器的操作,以处理格式不正确的输入错误。

OnUnmappableCharacter(CodingErrorAction)

更改此编码器的操作,以处理不可应用字符错误。

Replacement()

返回此编码器的替换值。

ReplaceWith(Byte[])

更改此编码器的替换值。

Reset()

重置此编码器,清除任何内部状态。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnmappableCharacterAction()

返回此编码器的当前操作以获取不可应用字符错误。

UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于