| |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.nio
类 LongBuffer
java.lang.Object java.nio.Buffer java.nio.LongBuffer
- 所有已实现的接口:
- Comparable<LongBuffer>
public abstract class LongBuffer
- extends Buffer
- implements Comparable<LongBuffer>
long 缓冲区。
此类定义了 long 缓冲区上的四类操作:
将此缓冲区的连续 long 序列传输到数组中的相对批量 get
方法;
将 long 数组或其他 long 缓冲区中的连续 long 序列传输到此缓冲区的相对批量 put
方法;以及
long 缓冲区的 compacting
、
duplicating
和
slicing
方法。
long 缓冲区可以通过 allocation
创建,此方法通过
wrapping
将一个现有 long 数组包装到缓冲区中来为缓冲区内容分配空间,或者通过创建现有字节缓冲区的视图来创建。
像字节缓冲区一样,long 缓冲区要么是直接的,要么是非直接的。通过此类的 wrap 方法创建的 long 缓冲区将是非直接的。当且仅当字节缓冲区本身为直接时,作为字节缓冲区的视图创建的 long 缓冲区才是直接的。通过调用 isDirect
方法可以确定 long 缓冲区是否为直接的。
指定此类中的方法(它们不返回其他值),以返回这些方法被调用时所在的缓冲区。这允许对方法调用进行链接。
- 从以下版本开始:
- 1.4
方法摘要 | |
---|---|
static LongBuffer | allocate(int capacity) 分配新的 long 缓冲区。 |
long[] | array() 返回实现此缓冲区的 long 数组(可选操作)。 |
int | arrayOffset() 返回此缓冲区中第一个元素在缓冲区的支持数组中的偏移量(可选操作)。 |
abstract LongBuffer | asReadOnlyBuffer() 创建共享此缓冲区内容的新的只读 long 缓冲区。 |
abstract LongBuffer | compact() 压缩此缓冲区(可选操作)。 |
int | compareTo(LongBuffer that) 将此缓冲区与另一个缓冲区进行比较。 |
abstract LongBuffer | duplicate() 创建共享此缓冲区内容的新的 long 缓冲区。 |
boolean | equals(Object ob) 判断此缓冲区是否与另一个对象相同。 |
abstract long | get() 相对 get 方法。 |
abstract long | get(int index) 绝对 get 方法。 |
LongBuffer | get(long[] dst) 相对批量 get 方法。 |
LongBuffer | get(long[] dst, int offset, int length) 相对批量 get 方法。 |
boolean | hasArray() 判断是否可通过一个可访问的 long 数组实现此缓冲区。 |
int | hashCode() 返回此缓冲区的当前哈希码。 |
abstract boolean | isDirect() 判断此 long 缓冲区是否为直接的。 |
abstract ByteOrder | order() 检索此缓冲区的字节顺序。 |
abstract LongBuffer | put(int index, long l) 绝对 put 方法(可选操作)。 |
abstract LongBuffer | put(long l) 相对 put 方法(可选操作)。 |
LongBuffer | put(long[] src) 相对批量 put 方法(可选操作)。 |
LongBuffer | put(long[] src, int offset, int length) 相对批量 put 方法(可选操作)。 |
LongBuffer | put(LongBuffer src) 相对批量 put 方法(可选操作)。 |
abstract LongBuffer | slice() 创建新的 long 缓冲区,其内容是此缓冲区内容的共享子序列。 |
String | toString() 返回总结了此缓冲区状态的字符串。 |
static LongBuffer | wrap(long[] array) 将 long 数组包装到缓冲区中。 |
static LongBuffer | wrap(long[] array, int offset, int length) 将 long 数组包装到缓冲区中。 |
从类 java.nio.Buffer 继承的方法 |
---|
capacity, clear, flip, hasRemaining, isReadOnly, limit, limit, mark, position, position, remaining, reset, rewind |
从类 java.lang.Object 继承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
方法详细信息 |
---|
allocate
public static LongBuffer allocate(int capacity)
- 分配新的 long 缓冲区。
- 参数:
capacity
- 新缓冲区的容量,以 long 为单位- 返回:
- 新的 long 缓冲区
- 抛出:
IllegalArgumentException
- 如果 capacity 为负整数
wrap
public static LongBuffer wrap(long[] array, int offset, int length)
- 将 long 数组包装到缓冲区中。
给定 long 数组将支持新缓冲区;即缓冲区修改将导致数组修改,反之亦然。新缓冲区的容量将为 array.length,其位置将为 offset,其界限将为 offset + length,其标记是未定义的。其
底层实现数组
将为给定数组,并且其
数组偏移量
将为零。
- 参数:
array
- 支持新缓冲区的数组offset
- 要使用的子数组的偏移量;必须为非负且不大于 array.length。将新缓冲区的位置设置为此值。length
- 要使用的子数组的长度;必须为非负且不大于 array.length - offset。将新缓冲区的界限设置为 offset + length。- 返回:
- 新的 long 缓冲区
- 抛出:
IndexOutOfBoundsException
- 如果关于 offset 和 length 参数的前提不成立
wrap
public static LongBuffer wrap(long[] array)
- 将 long 数组包装到缓冲区中。
给定 long 数组将支持新缓冲区;即缓冲区修改将导致数组修改,反之亦然。新缓冲区的容量和界限将为 array.length,其位置将为零,其标记是未定义的。其
底层实现数组
将为给定数组,并且其
数组偏移量
将为零。
- 参数:
array
- 实现此缓冲区的数组- 返回:
- 新的 long 缓冲区
slice
public abstract LongBuffer slice()
- 创建新的 long 缓冲区,其内容是此缓冲区内容的共享子序列。
新缓冲区的内容将从此缓冲区的当前位置开始。此缓冲区内容的更改在新缓冲区中是可见的,反之亦然;这两个缓冲区的位置、界限和标记值是相互独立的。
新缓冲区的位置将为零,其容量和界限将为此缓冲区中所剩余的 long 数量,其标记是未定义的。当且仅当此缓冲区为直接时,新缓冲区才是直接的,当且仅当此缓冲区为只读时,新缓冲区才是只读的。
- 返回:
- 新的 long 缓冲区
duplicate
public abstract LongBuffer duplicate()
- 创建共享此缓冲区内容的新的 long 缓冲区。
新缓冲区的内容将为此缓冲区的内容。此缓冲区内容的更改在新缓冲区中是可见的,反之亦然;这两个缓冲区的位置、界限和标记值是相互独立的。
新缓冲区的容量、界限、位置和标记值将与此缓冲区相同。当且仅当此缓冲区为直接时,新缓冲区才是直接的,当且仅当此缓冲区为只读时,新缓冲区才是只读的。
- 返回:
- 新的 long 缓冲区
asReadOnlyBuffer
public abstract LongBuffer asReadOnlyBuffer()
- 创建共享此缓冲区内容的新的只读 long 缓冲区。
新缓冲区的内容将为此缓冲区的内容。此缓冲区的更改在新缓冲区中是可见的,但新缓冲区将是只读的并且不允许修改共享内容。两个缓冲区的位置、界限和标记值是相互独立的。
新缓冲区的容量、界限、位置和标记值将与此缓冲区相同。
如果此缓冲区本身是只读的,则此方法与
duplicate
方法完全相同。 - 返回:
- 新的只读 long 缓冲区
get
public abstract long get()
- 相对 get 方法。读取此缓冲区当前位置的 long,然后该位置递增。
- 返回:
- 缓冲区当前位置的 long
- 抛出:
BufferUnderflowException
- 如果缓冲区当前位置不小于其界限