Buffer 类

定义

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

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

继承

Object

Object

Buffer

派生

Java.Nio.ByteBuffer

Java.Nio.CharBuffer

Java.Nio.DoubleBuffer

Java.Nio.FloatBuffer

Java.Nio.IntBuffer

更多…

属性

RegisterAttribute

注解

特定基元类型的数据的容器。

缓冲区是特定基元类型的线性有限元素序列。 除了缓冲区的内容之外，缓冲区的基本属性是其容量、限制和位置：

<blockquote>

缓冲区的 容量 是它所包含的元素数。 缓冲区的容量永远不会为负数，也永远不会更改。

缓冲区 的限制 是不应读取或写入的第一个元素的索引。 缓冲区的限制从不为负，并且永远不会大于其容量。

缓冲区 的位置 是要读取或写入的下一个元素的索引。 缓冲区的位置从不为负，并且永远不会大于其限制。

</blockquote>

对于每个非布尔基元类型，此类有一个子类。

<h2> 传输数据 </h2>

此类的每个子类定义 两个获取 和 放置 操作类别：

<blockquote>

相对 操作从当前位置开始读取或写入一个或多个元素，然后通过传输的元素数递增位置。 如果请求的传输超出限制，则相对 get 操作会引发一个 BufferUnderflowException ，而相对 放置 操作将引发一个 BufferOverflowException;在任一情况下，不会传输任何数据。

绝对 操作采用显式元素索引，不会影响位置。 如果索引参数超出限制，则绝对 获取 和 放置 操作将引发 IndexOutOfBoundsException 。

</blockquote>

当然，数据也可以由相应通道的 I/O 操作传入或传出缓冲区，这些操作始终相对于当前位置。

<h2> 标记和重置 </h2>

缓冲区的 标记 是调用方法时将重置其位置的 #reset reset 索引。 标记并非始终定义，但在定义标记时，它永远不会为负，并且永远不会大于位置。 如果定义了标记，则在将位置或限制调整为小于标记的值时，将放弃标记。 如果未定义标记，则调用 #reset reset 该方法会导致 InvalidMarkException 引发。

<h2> 固定器 </h2>

以下固定保留标记、位置、限制和容量值：

<blockquote><=0标记<=位置<=限制<=容量</blockquote>

新创建的缓冲区始终具有零的位置和未定义的标记。 初始限制可以是零，也可能是一些其他值，具体取决于缓冲区的类型及其构造方式。 新分配的缓冲区的每个元素初始化为零。

<h2> 其他操作 </h2>

除了访问位置、限制和容量值以及标记和重置的方法外，此类还在缓冲区上定义以下操作：

<ul>

<li>

#clear 将缓冲区设置为新的通道读取或相对 放置 操作序列：它将容量限制和位置设置为零。

</li>

<li>

#flip 将缓冲区设置为新的通道写入或相对 获取 操作序列：它将限制设置为当前位置，然后将位置设置为零。

</li>

<li>

#rewind 使缓冲区准备好重新读取它已包含的数据：它将保留限制不变，并将位置设置为零。

</li>

<li>

和#slice#slice(int,int) slice(index,length)方法创建缓冲区的子序列：它们保留限制和位置不变。

</li>

<li>

#duplicate 创建缓冲区的浅表副本：它会保留限制和位置不变。

</li>

</ul>

<h2> 只读缓冲区 </h2>

每个缓冲区都是可读的，但并非每个缓冲区都是可写的。 每个缓冲区类的突变方法被指定为 可选操作 ，将在对只读缓冲区调用时引发 ReadOnlyBufferException 该操作。 只读缓冲区不允许更改其内容，但其标记、位置和限制值是可变的。 缓冲区是否为只读，都可以通过调用其 #isReadOnly isReadOnly 方法来确定。

<h2> 线程安全 </h2>

多个并发线程使用缓冲区不安全。 如果缓冲区由多个线程使用，则应通过适当的同步来控制对缓冲区的访问。

<h2> 调用链接 </h2>

此类中不具有要返回的值的方法将指定为返回调用它们的缓冲区。 这允许链接方法调用;例如，语句序列

<blockquote>

b.flip();
            b.position(23);
            b.limit(42);

</blockquote>

可以替换为单个、更精简的语句

<blockquote>

b.flip().position(23).limit(42);

</blockquote>

在 1.4 中添加。

Java文档java.nio.Buffer。

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