java命名空间java.nio.charset类charsetdecoder的类成员方法: decode定义及介绍

发布时间:2014-2-17

本文导语: decode public final coderresult decode(bytebuffer in, charbuffer out, boolean endofinput) 从给定的输入缓冲区中解码尽可能多的字节，把结果写入给定的输出缓冲区。应该从各缓冲区的当前位...

decode

public final coderresult decode(bytebuffer in,
                                charbuffer out,
                                boolean endofinput)

从给定的输入缓冲区中解码尽可能多的字节，把结果写入给定的输出缓冲区。

应该从各缓冲区的当前位置开始进行读取和写入。最多将读取 in.remaining() 个字节，最多将写入 out.remaining() 个字符。前移缓冲区的位置，以反映字节读取和写入字符，但是其标记和界限将无法修改。

除了从输入缓冲区读取字节和向输出缓冲区写入字符，此方法还返回一个 coderresult 对象来描述它终止的原因：

coderresult.underflow 指示已解码尽可能多的输入缓冲区。如果没有进一步的输入，则调用者可以进行到解码操作的下一个步骤。否则，应该使用进一步的输入再次调用此方法。
coderresult.overflow 指示该输出缓冲区中没有足够空间来解码任何更多字节。应该使用具有更多剩余字符的输出缓冲区再次调用此方法。这通常是通过排空输出缓冲区的所有解码字符来完成的。
coderresult#malformedforlengthmalformed-input 结果指示已检测到错误输入错误。错误的字节起始于输入缓冲区（可能向前增加）的位置；错误字节数可以通过调用结果对象的 length 方法来确定。这种情况只适用于此解码器的错误输入的动作是 codingerroraction.report 的情况下；否则将像请求的那样忽略或替换错误的输入。
unmappable-character 结果指示已检测到不可映射的字符错误。解码不可映射的字符的字节起始于输入缓冲区（可能向前增加）的位置；这种字节的数目可以通过调用结果对象的 length 方法来确定。这种情况只适用于此解码器的不可映射的字符的动作是 codingerroraction.report的情况下；否则将像请求的那样忽略或替换不可映射的字符。

在任一情况下，如果在相同的解码操作中调用此方法，则要注意保留输入缓冲区中剩余的所有字节，以便可提供给下一次调用使用。

endofinput 参数通知此方法除了给定输入缓冲区包含的内容，调用者是否能提供更多的输入。如果可能提供其他的输入，则调用者应该为此参数传递 false；如果不能提供更多的输入，则调用者应该传递 true。实际上在一次调用中传递 false，但后来发现实际上没有更多的输入可用是相当普遍的，这不是错误。但关键是，在此方法的一系列调用中，最后一次调用总是传递 true，这样所有剩余的未解码输入都作为错误输入处理。

此方法通过调用 decodeloop 方法、解释它的结果、处理错误情况并重新调用（如有必要）来完成其工作。

参数：: in - 输入字节缓冲区; out - 输出字符缓冲区; endofinput - 当且仅当调用者除了给定缓冲区中的内容外不提供其他输入字节时才为 true

返回：

描述终止原因的 coderresult 对象

抛出：

illegalstateexception - 如果解码操作已在进行中并且前面的步骤不是调用 reset 方法，也不是为 endofinput 参数使用 false 来调用此方法，也不是为 endofinput 参数使用 true 来调用此方法，而是一个指示未完成解码操作的返回值

codermalfunctionerror - 如果对 decodeloop 方法的调用抛出不可预料的异常

您可能感兴趣的文章:

本站(WWW.)旨在分享和传播互联网科技相关的资讯和技术，将尽最大努力为读者提供更好的信息聚合和浏览方式。
本站(WWW.)站内文章除注明原创外，均为转载,整理或搜集自网络.欢迎任何形式的转载，转载请注明出处.
转载请注明：文章转载自:[169IT-IT技术资讯]
本文标题:java命名空间java.nio.charset类charsetdecoder的类成员方法: decode定义及介绍

java文件重命名(文件批量重命名)实例程序代码分享

java命名空间java.beans接口propertyeditor的类成员方法: getvalue定义及介绍

java 命名空间命名规则第1/2页

java命名空间java.awt类container的类成员方法: getlayout定义及介绍

Linux 下 java 的File类的renameTo（）方法不能重命名文件

java命名空间java.beans类defaultpersistencedelegate的类成员方法: defaultpersistencedelegate定义及介绍

Java命名规则详细总结

java命名空间java.text类decimalformat的类成员方法: topattern定义及介绍

Java Web项目前端规范(采用命名空间使js深度解耦合)

java命名空间java.sql类types的类成员方法: null定义及介绍

java的命名规则默认是不是匈牙利命名法？

java命名空间java.awt类awtevent的类成员方法: id定义及介绍