CharsetEncoder.Encode 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| Encode(CharBuffer) |
将单个输入字符缓冲区的剩余内容编码为新分配的字节缓冲区的便利方法。 |
| Encode(CharBuffer, ByteBuffer, Boolean) |
从给定输入缓冲区对任意数量的字符进行编码,并将结果写入给定的输出缓冲区。 |
Encode(CharBuffer)
将单个输入字符缓冲区的剩余内容编码为新分配的字节缓冲区的便利方法。
[Android.Runtime.Register("encode", "(Ljava/nio/CharBuffer;)Ljava/nio/ByteBuffer;", "")]
public Java.Nio.ByteBuffer? Encode(Java.Nio.CharBuffer? in);
[<Android.Runtime.Register("encode", "(Ljava/nio/CharBuffer;)Ljava/nio/ByteBuffer;", "")>]
member this.Encode : Java.Nio.CharBuffer -> Java.Nio.ByteBuffer
参数
- in
- CharBuffer
输入字符缓冲区
返回
包含编码操作结果的新分配字节缓冲区。 缓冲区的位置将为零,其限制将遵循写入的最后一个字节。
- 属性
例外
如果正在进行另一个编码操作,
如果遇到此字符集的非法输入字符序列,并且格式错误的操作为 Report
如果遇到此字符集的合法但不可应用的输入字符序列,并且无法应用字符错误的操作为 Report。 不可应用意味着输入缓冲区当前位置的 Unicode 字符序列无法映射到等效的字节序列。
如果在编码操作期间发生其他异常,
注解
将单个输入字符缓冲区的剩余内容编码为新分配的字节缓冲区的便利方法。
此方法实现整个编码操作;也就是说,它会重置此编码器,然后对给定字符缓冲区中的字符进行编码,最后刷新此编码器。 因此,如果编码操作正在进行中,则不应调用此方法。
Java文档java.nio.charset.CharsetEncoder.encode(java.nio.CharBuffer)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
Encode(CharBuffer, ByteBuffer, Boolean)
从给定输入缓冲区对任意数量的字符进行编码,并将结果写入给定的输出缓冲区。
[Android.Runtime.Register("encode", "(Ljava/nio/CharBuffer;Ljava/nio/ByteBuffer;Z)Ljava/nio/charset/CoderResult;", "")]
public Java.Nio.Charset.CoderResult? Encode(Java.Nio.CharBuffer? in, Java.Nio.ByteBuffer? out, bool endOfInput);
[<Android.Runtime.Register("encode", "(Ljava/nio/CharBuffer;Ljava/nio/ByteBuffer;Z)Ljava/nio/charset/CoderResult;", "")>]
member this.Encode : Java.Nio.CharBuffer * Java.Nio.ByteBuffer * bool -> Java.Nio.Charset.CoderResult
参数
- in
- CharBuffer
输入字符缓冲区
- out
- ByteBuffer
输出字节缓冲区
- endOfInput
- Boolean
true 如果,并且仅当调用程序不能在给定缓冲区中提供其他输入字符时
返回
描述终止原因的编码器结果对象
- 属性
例外
如果编码操作已启动或在此编码过程中不需要输入,则为 。
EncodeLoop(CharBuffer, ByteBuffer)如果方法抛出BufferUnderflowException或 BufferUnderflowException。
注解
从给定输入缓冲区对任意数量的字符进行编码,并将结果写入给定的输出缓冲区。
从缓冲区当前位置开始读取缓冲区并写入缓冲区。 最多 Buffer#remaining in.remaining() 将读取字符,最多 Buffer#remaining out.remaining() 写入字节数。 缓冲区的位置将进行高级,以反映读取的字符和写入的字节,但不会修改它们的标记和限制。
除了从输入缓冲区读取字符并将字节写入输出缓冲区之外,此方法还返回一个 CoderResult 对象来描述其终止原因:
<ul>
<li>
CoderResult#UNDERFLOW 指示已对尽可能多的输入缓冲区进行编码。 如果没有进一步输入,调用程序可以继续执行编码操作的下一步。 否则,应使用进一步输入再次调用此方法。
</li>
<li>
CoderResult#OVERFLOW 指示输出缓冲区中空间不足,无法对更多字符进行编码。 应再次使用具有更多 Buffer#剩余字节的输出缓冲区调用此方法。 这通常是通过从输出缓冲区中清空任何编码字节来完成的。
</li>
<li>
CoderResult#malformedForLength 格式不正确的输入结果指示检测到格式不正确的输入错误。 格式不正确的字符从输入缓冲区(可能递增)位置开始;格式不正确的字符数可以通过调用结果对象的 CoderResult#length() length 方法来确定。 仅当此编码器 CodingErrorAction#REPORT的 #onMalformedInput 格式不正确操作时,此情况才适用;否则,将按请求忽略或替换格式不正确的输入。
</li>
<li>
CoderResult#unmappableForLength unmappable-character 结果指示检测到不可应用字符错误。 编码不可应用字符的字符从输入缓冲区(可能递增)位置开始;可以通过调用结果对象的 CoderResult#length() length 方法来确定此类字符的数目。 仅当此编码器 CodingErrorAction#REPORT的 #onUnmappableCharacter 不可应用操作时,此情况才适用;否则,将按请求忽略或替换不可应用字符。
</li>
</ul>
在任何情况下,如果要在同一编码操作中重新调用此方法,则应注意保留输入缓冲区中剩余的任何字符,以便它们可用于下一次调用。
该 endOfInput 参数建议此方法,即调用方是否可以提供超出给定输入缓冲区中包含的进一步输入。 如果有可能提供其他输入,则调用程序应传递 false 此参数;如果没有提供进一步输入的可能性,则调用程序应传递 true。 这不是错误的,事实上,传递一个调用是相当常见的, false 后来发现没有进一步的输入实际可用。 但是,在一系列调用中对此方法的最终调用始终传递 true 至关重要,以便将任何剩余未编码的输入视为格式不正确。
此方法的工作原理是调用 #encodeLoop encodeLoop 该方法、解释其结果、处理错误条件以及根据需要重新调用它。
Java文档java.nio.charset.CharsetEncoder.encode(java.nio.CharBuffer, java.nio.ByteBuffer, boolean)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。