public abstract class DoubleBuffer extends Buffer implements Comparable<DoubleBuffer>
此类定义了双缓冲区中的四类操作:
相对bulk get
方法将连续的双倍序列从该缓冲区传输到阵列中; 和
相对的bulk put
方法,将双重阵列或其他双缓冲区的连续序列双向传输到此缓冲区中; 和
方法compacting
, duplicating
和slicing
双缓冲。
双缓冲区可以由allocation
创建,它为缓冲区的内容分配空间,将现有的双阵列分配到缓冲区中,或通过创建现有字节缓冲区的view 。
像一个字节缓冲区一样,双缓冲区是direct or non-direct 。 通过此类的wrap方法创建的双缓冲区将是非直接的。 创建为字节缓冲区视图的双缓冲区将是直接的,只有当字节缓冲区本身是直接的。 双缓冲区是否直接可以通过调用isDirect
方法来确定。
指定此类中没有值返回值的方法返回调用它们的缓冲区。 这允许方法调用被链接。
Modifier and Type | Method and Description |
---|---|
static DoubleBuffer |
allocate(int capacity)
分配一个新的双缓冲区。
|
double[] |
array()
返回支持此缓冲区的double数组
(可选操作) 。
|
int |
arrayOffset()
返回该缓冲区的缓冲区的第一个元素的背衬数组中的偏移量
(可选操作) 。
|
abstract DoubleBuffer |
asReadOnlyBuffer()
创建一个新的只读双缓冲区,共享此缓冲区的内容。
|
abstract DoubleBuffer |
compact()
压缩此缓冲区
(可选操作) 。
|
int |
compareTo(DoubleBuffer that)
将此缓冲区与另一个缓冲区进行比较。
|
abstract DoubleBuffer |
duplicate()
创建一个新的双缓冲区,共享此缓冲区的内容。
|
boolean |
equals(Object ob)
告诉这个缓冲区是否等于另一个对象。
|
abstract double |
get()
相对
获取方法。
|
DoubleBuffer |
get(double[] dst)
相对批量
获取方法。
|
DoubleBuffer |
get(double[] dst, int offset, int length)
相对批量
获取方法。
|
abstract double |
get(int index)
绝对
获取方法。
|
boolean |
hasArray()
告诉这个缓冲区是否由可访问的双阵列支持。
|
int |
hashCode()
返回此缓冲区的当前哈希码。
|
abstract boolean |
isDirect()
告诉这个双缓冲区是否直接。
|
abstract ByteOrder |
order()
检索此缓冲区的字节顺序。
|
abstract DoubleBuffer |
put(double d)
相对
放置法
(可选操作) 。
|
DoubleBuffer |
put(double[] src)
相对大容量
put方法
(可选操作) 。
|
DoubleBuffer |
put(double[] src, int offset, int length)
相对大容量
put方法
(可选操作) 。
|
DoubleBuffer |
put(DoubleBuffer src)
相对大容量
put方法
(可选操作) 。
|
abstract DoubleBuffer |
put(int index, double d)
绝对
put方法
(可选操作) 。
|
abstract DoubleBuffer |
slice()
创建一个新的双缓冲区,其内容是此缓冲区内容的共享子序列。
|
String |
toString()
返回一个汇总此缓冲区状态的字符串。
|
static DoubleBuffer |
wrap(double[] array)
将双阵列包装到缓冲区中。
|
static DoubleBuffer |
wrap(double[] array, int offset, int length)
将双阵列包装到缓冲区中。
|
public static DoubleBuffer allocate(int capacity)
新缓冲区的位置将为零,其限制将为其容量,其标记将不定义,并且其每个元素将被初始化为零。 它将有一个backing array
,其array offset
将为零。
capacity
- 新的缓冲区的容量,双打
IllegalArgumentException
- 如果
capacity是负整数
public static DoubleBuffer wrap(double[] array, int offset, int length)
新缓冲区将由给定的双数组支持; 也就是说,对缓冲区的修改将导致数组被修改,反之亦然。 新增的缓冲区容量将为array.length ,其职位将为offset ,其限制将为offset + length ,其标志将不定。 它的backing array
将是给定的数组,其array offset
将为零。
array
- 将返回新缓冲区的数组
offset
- 要使用的子阵列的偏移量;
必须是非负数,不得大于array.length 。
新缓冲区的位置将被设置为此值。
length
- 要使用的子阵列的长度;
必须是非负数,不得大于array.length - offset 。
新缓冲区的限制将设置为offset + length 。
IndexOutOfBoundsException
- 如果
offset和
length参数的前提条件不成立
public static DoubleBuffer wrap(double[] array)
新缓冲区将由给定的双数组支持; 也就是说,对缓冲区的修改将导致数组被修改,反之亦然。 新缓冲区的容量和限制将为array.length ,其位置将为零,其标记将不定。 它的backing array
将是给定的数组,其array offset>
将为零。
array
- 将返回此缓冲区的数组
public abstract DoubleBuffer slice()
新缓冲区的内容将从此缓冲区的当前位置开始。 对这个缓冲区内容的更改将在新的缓冲区中可见,反之亦然; 两个缓冲区的位置,极限和标记值将是独立的。
新缓冲区的位置将为零,其容量和限制将是此缓冲区中剩余的双精度数,其标记将不确定。 如果只有这个缓冲区是直接的,并且只有当这个缓冲区是只读的时,这个缓冲区将是只读的。
public abstract DoubleBuffer duplicate()
新缓冲区的内容将是这个缓冲区的内容。 对这个缓冲区内容的更改将在新的缓冲区中可见,反之亦然; 两个缓冲区的位置,极限和标记值将是独立的。
新缓冲区的容量,限制,位置和标记值将与此缓冲区的容量,限制,位置和标记值相同。 如果只有这个缓冲区是直接的,并且只有当这个缓冲区是只读的时,这个缓冲区将是只读的。
public abstract DoubleBuffer asReadOnlyBuffer()
新缓冲区的内容将是这个缓冲区的内容。 这个缓冲区内容的更改将在新的缓冲区中显示; 然而,新的缓冲区本身将是只读的,不允许修改共享内容。 两个缓冲区的位置,极限和标记值将是独立的。
新缓冲区的容量,限制,位置和标记值将与此缓冲区的容量,限制,位置和标记值相同。
如果这个缓冲区本身是只读的,那么这个方法的行为与duplicate
方法完全相同。
public abstract double get()
BufferUnderflowException
- 如果缓冲区的当前位置不小于其限制
public abstract DoubleBuffer put(double d)
将给定的double写入到当前位置的缓冲区中,然后增加位置。
d
-
d
的两倍
BufferOverflowException
- 如果此缓冲区的当前位置不小于其限制
ReadOnlyBufferException
- 如果此缓冲区是只读的
public abstract double get(int index)
index
- 将从中读取双精度的索引
IndexOutOfBoundsException
- 如果
index为负值或不小于缓冲区限制
public abstract DoubleBuffer put(int index, double d)
将给定的double写入给定索引的缓冲区。
index
- 将双面写入的索引
d
-
d
的双重值
IndexOutOfBoundsException
- 如果
index为负数或不小于缓冲区限制
ReadOnlyBufferException
- 如果此缓冲区是只读的
public DoubleBuffer get(double[] dst, int offset, int length)
此方法将双缓冲区从该缓冲区传输到给定的目标数组。 如果缓冲区中剩余的双精度少于满足请求所需的双精度,即length > remaining() ,则不会传输双精度,并抛出BufferUnderflowException
。
否则,该方法将length从此缓冲区复制到给定的数组中,从该缓冲区的当前位置开始,并在数组中给定的偏移量。 此缓冲区的位置然后增加length 。
换句话说,这种形式为src.get(dst, off, len)的方法的调用与循环完全相同
for (int i = off; i < off + len; i++) dst[i] = src.get():
除了它首先检查这个缓冲区中是否有足够的双打,并且它可能更有效率。
dst
- 要写入双精度数组
offset
- 要写入的第一个double的数组中的偏移量;
必须是非负数,不得大于dst.length
length
- 要写入给定数组的最大双精度数;
必须是非负数,不得大于dst.length - offset
BufferUnderflowException
- 如果此缓冲区中剩余的数字少于
length
IndexOutOfBoundsException
- 如果
offset和
length参数的前提条件不成立
public DoubleBuffer get(double[] dst)
此方法将双缓冲区从该缓冲区传输到给定的目标数组。 调用此方法的形式src.get(a)的行为方式与调用完全相同
src.get(a, 0, a.length)
dst
- 目的地阵列
BufferUnderflowException
- 如果此缓冲区中少于
length双打
public DoubleBuffer put(DoubleBuffer src)
该方法将给定源缓冲区中剩余的双精度传输到此缓冲区。 如果源缓冲区中剩余的双精度比缓冲区多,也就是说,如果src.remaining() > remaining() ,则不会传输双精度,并抛出BufferOverflowException
。
否则,该方法将n = src.remaining()从给定缓冲区复制到此缓冲区中,从每个缓冲区的当前位置开始。 然后将两个缓冲器的位置递增n 。
换句话说,这种dst.put(src)形式的方法的调用与循环完全相同
while (src.hasRemaining())
dst.put(src.get());
除了它首先检查这个缓冲区中是否有足够的空间,并且它可能更有效率。
src
- 要读取双精度的源缓冲区;
不能是这个缓冲区
BufferOverflowException
- 如果此缓冲区中的源缓冲区中剩余的双精度空间不足
IllegalArgumentException
- 如果源缓冲区是这个缓冲区
ReadOnlyBufferException
- 如果这个缓冲区是只读的
public DoubleBuffer put(double[] src, int offset, int length)
该方法从给定的源数组传输到该缓冲区的双精度。 如果从数组中复制的数量多于保留在此缓冲区中的两倍,也就是说,如果length > remaining() , 则不 传输双精度,并抛出BufferOverflowException
。
否则,该方法将length从给定数组复制到此缓冲区中,从阵列中的给定偏移量和此缓冲区的当前位置开始。 此缓冲区的位置然后增加length 。
换句话说,调用这种形式dst.put(src, off, len)的方法与循环完全相同
for (int i = off; i < off + len; i++) dst.put(a[i]);
除了它首先检查这个缓冲区中是否有足够的空间,并且它可能更有效率。
src
- 要读取双精度的数组
offset
- 要读取的第一个double数组中的偏移量;
必须是非负数,不得大于array.length
length
- 从给定数组读取的双精度数;
必须是非负数,不得大于array.length - offset
BufferOverflowException
- 如果此缓冲区空间不足
IndexOutOfBoundsException
- 如果
offset和
length参数的前提条件不成立
ReadOnlyBufferException
- 如果此缓冲区为只读
public final DoubleBuffer put(double[] src)
此方法将给定源双数组的整个内容传输到此缓冲区。 调用此方法的形式dst.put(a)的行为方式与调用完全相同
dst.put(a, 0, a.length)
src
- 源数组
BufferOverflowException
- 如果此缓冲区空间不足
ReadOnlyBufferException
- 如果此缓冲区是只读的
public final boolean hasArray()
如果此方法返回true,则可以安全地调用array
和arrayOffset
方法。
public final double[] array()
array
在类别
Buffer
ReadOnlyBufferException
- 如果此缓冲区由数组支持但是只读
UnsupportedOperationException
- 如果此缓冲区未由可访问阵列支持
public final int arrayOffset()
如果缓冲区由数组支持,那么缓冲位置p对应于数组索引p + arrayOffset() 。
在调用此方法之前调用hasArray
方法,以确保此缓冲区具有可访问的后台阵列。
arrayOffset
在类别
Buffer
ReadOnlyBufferException
- 如果此缓冲区由数组支持但是只读
UnsupportedOperationException
- 如果此缓冲区未由可访问阵列支持
public abstract DoubleBuffer compact()
缓冲区的当前位置和其限制(如果有的话)之间的双精度被复制到缓冲区的开头。 也就是说,索引p = position()的双倍复制到索引零,索引p + 1处的double被复制到索引1,依此类推,直到索引limit()-1的双倍复制到索引n = limit() - 1 - p 。 然后将缓冲区的位置设置为n + 1 ,并将其限制设置为其容量。 标记如果被定义,则被丢弃。
缓冲区的位置设置为复制的双精度数,而不是零,因此可以通过调用另一个相对put方法来立即调用此方法。
ReadOnlyBufferException
- 如果此缓冲区是只读的
public abstract boolean isDirect()
public int hashCode()
双缓冲区的哈希码仅取决于其剩余的元素; 也就是说,从position()到limit() - 1的元素,并包括元素。
因为缓冲区哈希码是内容依赖的,所以使用缓冲区作为哈希映射或类似数据结构中的密钥是不合适的,除非知道它们的内容不会改变。
hashCode
在类别
Object
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
public boolean equals(Object ob)
两个双缓冲区是相等的,如果,只有如果,
它们具有相同的元素类型,
他们有相同数量的剩余元素,和
独立于其起始位置的剩余元素的两个序列是相等的。 该方法认为两个双元件a
和b
是如果相等(a == b) || (Double.isNaN(a) && Double.isNaN(b))
。 值-0.0
和+0.0
被认为是相等的,不像Double.equals(Object)
。
双缓冲区不等于任何其他类型的对象。
equals
在类别
Object
ob
- 要比较此缓冲区的对象
Object.hashCode()
, HashMap
public int compareTo(DoubleBuffer that)
将两个双缓冲区进行比较,比较其顺序的剩余元素的词典,而不考虑每个序列的起始位置在其相应的缓冲区内。 对对double
元素进行比较,仿佛通过调用Double.compare(double,double)
,除了-0.0
和0.0
被认为是相等的。 Double.NaN
被认为是等于自己和大于所有其他double
值(包括Double.POSITIVE_INFINITY
)。
双缓冲区与任何其他类型的对象无法比较。
compareTo
在界面
Comparable<DoubleBuffer>
that
- 要比较的对象。
public abstract ByteOrder order()
通过分配或通过包装现有double阵列创建的双缓冲区的字节顺序是native order
底层硬件。 创建为字节缓冲区的view的双缓冲区的字节顺序是创建视图时的字节缓冲区的字节顺序。
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.