- java.lang.Object
-
- java.nio.Buffer
-
- java.nio.IntBuffer
-
- All Implemented Interfaces:
-
Comparable<IntBuffer>
public abstract class IntBuffer extends Buffer implements Comparable<IntBuffer>
一个int缓冲区该类定义了int缓冲区中的四类操作:
相对
bulk get方法将连续的ints序列从该缓冲区传输到数组中; 和相对的
bulk put方法,将连续的int数组从int数组或其他int缓冲区传输到该缓冲区中; 和一个方法为
compacting一个int缓冲区。
Int缓冲区可以由
allocation创建,它为缓冲区的内容分配wrapping现有的int数组到缓冲区中,或通过创建现有字节缓冲区的view来创建空间 。像一个字节缓冲区一样,一个int缓冲区是direct or non-direct 。 通过
wrap方法创建的int缓冲区将是非直接的。 作为字节缓冲区视图创建的int缓冲区将是直接的,只有当字节缓冲区本身是直接的。 int缓冲区是否直接可以通过调用isDirect方法来确定。指定此类中没有值返回值的方法返回调用它们的缓冲区。 这允许方法调用被链接。
- 从以下版本开始:
- 1.4
-
-
方法摘要
所有方法 静态方法 接口方法 抽象方法 具体的方法 Modifier and Type 方法 描述 static IntBufferallocate(int capacity)分配一个新的int缓冲区。int[]array()返回支持此缓冲区的int数组 (可选操作) 。intarrayOffset()返回该缓冲区的缓冲区的第一个元素的背衬数组中的偏移量 (可选操作) 。abstract IntBufferasReadOnlyBuffer()创建一个新的只读int缓冲区,共享此缓冲区的内容。IntBufferclear()清除此缓冲区。abstract IntBuffercompact()压缩此缓冲区 (可选操作) 。intcompareTo(IntBuffer that)将此缓冲区与另一个缓冲区进abstract IntBufferduplicate()创建一个共享此缓冲区内容的新int缓冲区。booleanequals(Object ob)告诉这个缓冲区是否等于另一个对象。IntBufferflip()翻转这个缓冲区。abstract intget()相对 获取方法。abstract intget(int index)绝对 获取方法。IntBufferget(int[] dst)相对批量 获取方法。IntBufferget(int[] dst, int offset, int length)相对批量 获取方法。booleanhasArray()告诉这个缓冲区是否由可访问的int数组支持。inthashCode()返回此缓冲区的当前哈希码。abstract booleanisDirect()告诉这个int缓冲区是否直接。IntBufferlimit(int newLimit)设置此缓冲区的限制。IntBuffermark()将此缓冲区的标记设置在其位置。abstract ByteOrderorder()检索此缓冲区的字节顺序。IntBufferposition(int newPosition)设置这个缓冲区的位置。abstract IntBufferput(int i)相对 放置法 (可选操作) 。IntBufferput(int[] src)相对大容量 put方法 (可选操作) 。IntBufferput(int[] src, int offset, int length)相对大容量 put方法 (可选操作) 。abstract IntBufferput(int index, int i)绝对 put方法 (可选操作) 。IntBufferput(IntBuffer src)相对大容量 put方法 (可选操作) 。IntBufferreset()将此缓冲区的位置重置为先前标记的位置。IntBufferrewind()倒带这个缓冲区。abstract IntBufferslice()创建一个新的int缓冲区,其内容是此缓冲区内容的共享子序列。StringtoString()返回一个汇总此缓冲区状态的字符串。static IntBufferwrap(int[] array)将int数组包装到缓冲区中。static IntBufferwrap(int[] array, int offset, int length)将int数组包装到缓冲区中。-
Methods inherited from class java.nio.Buffer
capacity, hasRemaining, isReadOnly, limit, position, remaining
-
-
-
-
方法详细信息
-
allocate
public static IntBuffer allocate(int capacity)
分配一个新的int缓冲区。新缓冲区的位置将为零,其限制将为其容量,其标记将不定义,其每个元素将被初始化为零,其字节顺序将为底层硬件的
native order。 它将有一个backing array,其array offset将为零。- 参数
-
capacity- 新的缓冲区的容量,在ints - 结果
- 新的int缓冲区
- 异常
-
IllegalArgumentException- 如果capacity是负整数
-
wrap
public static IntBuffer wrap(int[] array, int offset, int length)
将int数组包装到缓冲区中。新的缓冲区将由给定的int数组支持; 也就是说,对缓冲区的修改将导致数组被修改,反之亦然。 新的缓冲区容量将为
array.length,其位置将为offset,其限制将为offset + length,其标记将不定义,其字节顺序将为底层硬件的native order。 其backing array将是给定的数组,其array offset将为零。- 参数
-
array- 将返回新缓冲区的数组 -
offset- 要使用的子阵列的偏移量; 必须是非负数,不得大于array.length。 新缓冲区的位置将被设置为此值。 -
length- 要使用的子阵列的长度; 必须是非负数,不得大于array.length - offset。 新缓冲区的限制将设置为offset + length。 - 结果
- 新的int缓冲区
- 异常
-
IndexOutOfBoundsException- 如果offset和length参数的前提条件不成立
-
wrap
public static IntBuffer wrap(int[] array)
将int数组包装到缓冲区中。新的缓冲区将由给定的int数组支持; 也就是说,对缓冲区的修改将导致数组被修改,反之亦然。 新缓冲区的容量和限制将为
array.length,其位置将为零,其标记将不定义,其字节顺序将为底层硬件的native order。 其backing array将是给定的数组,其array offset将为零。- 参数
-
array- 将返回此缓冲区的数组 - 结果
- 新的int缓冲区
-
slice
public abstract IntBuffer slice()
创建一个新的int缓冲区,其内容是此缓冲区内容的共享子序列。新缓冲区的内容将从此缓冲区的当前位置开始。 对这个缓冲区内容的更改将在新的缓冲区中可见,反之亦然; 两个缓冲区的位置,极限和标记值将是独立的。
新缓冲区的位置将为零,其容量和限制将是该缓冲区中剩余的int数,其标记将不定义,并且其字节顺序将与此缓冲区的字节顺序相同。 如果只有这个缓冲区是直接的,并且只有当这个缓冲区是只读的时,这个缓冲区将是只读的。
-
duplicate
public abstract IntBuffer duplicate()
创建一个共享此缓冲区内容的新int缓冲区。新缓冲区的内容将是这个缓冲区的内容。 对这个缓冲区内容的更改将在新的缓冲区中可见,反之亦然; 两个缓冲区的位置,极限和标记值将是独立的。
新缓冲区的容量,限制,位置,标记值和字节顺序将与此缓冲区的容量相同。 如果只有这个缓冲区是直接的,并且只有当这个缓冲区是只读的时,这个缓冲区将是只读的。
-
asReadOnlyBuffer
public abstract IntBuffer asReadOnlyBuffer()
创建一个新的只读int缓冲区,共享此缓冲区的内容。新缓冲区的内容将是这个缓冲区的内容。 这个缓冲区内容的更改将在新的缓冲区中显示; 但是,新的缓冲区本身将是只读的,不允许修改共享内容。 两个缓冲区的位置,极限和标记值将是独立的。
新缓冲区的容量,限制,位置,标记值和字节顺序将与此缓冲区的容量相同。
如果这个缓冲区本身是只读的,那么这个方法的行为与
duplicate的方法完全相同。- 结果
- 新的只读int缓冲区
-
get
public abstract int get()
相对获取方法。 在此缓冲区的当前位置读取int,然后增加位置。- 结果
- int在缓冲区的当前位置
- 异常
-
BufferUnderflowException- 如果缓冲区的当前位置不小于其限制
-
put
public abstract IntBuffer put(int i)
相对放置法(可选操作) 。将给定的int写入到当前位置的缓冲区中,然后增加位置。
- 参数
-
i-i的int - 结果
- 这个缓冲区
- 异常
-
BufferOverflowException- 如果此缓冲区的当前位置不小于其限制 -
ReadOnlyBufferException- 如果此缓冲区是只读的
-
get
public abstract int get(int index)
绝对获取方法。 读取给定索引的int。- 参数
-
index- 从中读取的索引 - 结果
- 在给定索引的int
- 异常
-
IndexOutOfBoundsException- 如果index为负数或不小于缓冲区限制
-
put
public abstract IntBuffer put(int index, int i)
绝对put方法(可选操作) 。将给定的int写入给定索引的缓冲区。
- 参数
-
index- 将写入int的索引 -
i- 要写入的int值 - 结果
- 这个缓冲区
- 异常
-
IndexOutOfBoundsException- 如果index为负数或不小于缓冲区限制 -
ReadOnlyBufferException- 如果此缓冲区是只读的
-
get
public IntBuffer get(int[] dst, int offset, int length)
相对批量获取方法。此方法将int从此缓冲区传输到给定的目标数组。 如果缓冲区中剩余的内容少于满足请求所需的int,那么,如果
length>remaining(),则不传输int,并抛出一个BufferUnderflowException。否则,此方法将
lengthint从此缓冲区复制到给定的数组中,从该缓冲区的当前位置开始,并在数组中给定的偏移量。 然后将该缓冲区的位置增加length。换句话说,这种
src.get(dst, off, len)形式的方法的调用与循环完全相同除了它首先检查这个缓冲区中是否有足够的int,并且它可能更有效率。for (int i = off; i < off + len; i++) dst[i] = src.get():- 参数
-
dst- 要写入int的数组 -
offset- 要写入的第一个int的数组中的偏移量; 必须是非负数,不得大于dst.length -
length- 要写入给定数组的最大int数; 必须是非负数,不得大于dst.length - offset - 结果
- 这个缓冲区
- 异常
-
BufferUnderflowException- 如果此缓冲区中剩余的内容不足length -
IndexOutOfBoundsException- 如果offset和length参数的前提条件不成立
-
get
public IntBuffer get(int[] dst)
相对批量获取方法。此方法将int从此缓冲区传输到给定的目标数组。 调用此方法的形式为
src.get(a)行为方式与调用完全相同src.get(a, 0, a.length)- 参数
-
dst- 目的地阵列 - 结果
- 这个缓冲区
- 异常
-
BufferUnderflowException- 如果此缓冲区中剩余的数字少于lengthint
-
put
public IntBuffer put(IntBuffer src)
相对大容量put方法(可选操作) 。该方法将给定源缓冲区中剩余的int传输到此缓冲区。 如果源缓冲区中存在比在此缓冲区中剩余的多个int,也就是说,如果
src.remaining()>remaining(),则不传输int,并抛出一个27056926636363639 。否则,该方法将n =
src.remaining()int从给定缓冲区复制到此缓冲区中,从每个缓冲区的当前位置开始。 然后将两个缓冲器的位置递增n 。换句话说,这种形式为
dst.put(src)方法的调用与循环完全相同while (src.hasRemaining()) dst.put(src.get());除了它首先检查这个缓冲区中是否有足够的空间,并且它可能更有效率。- 参数
-
src- 要读取int的源缓冲区; 不能是这个缓冲区 - 结果
- 这个缓冲区
- 异常
-
BufferOverflowException- 如果此缓冲区中的源缓冲区中剩余的int没有足够的空间 -
IllegalArgumentException- 如果源缓冲区是这个缓冲区 -
ReadOnlyBufferException- 如果此缓冲区是只读的
-
put
public IntBuffer put(int[] src, int offset, int length)
相对大容量put方法(可选操作) 。此方法将ints从给定的源数组传输到这个缓冲区。 如果从数组中复制的内容多于保留在此缓冲区中,即
length>remaining(),则不会传输任何int,并抛出一个BufferOverflowException。否则,该方法
length定数组中的lengthint复制到此缓冲区中,从阵列中的给定偏移量和此缓冲区的当前位置开始。 此缓冲区的位置然后增加length。换句话说,这种形式为
dst.put(src, off, len)方法的调用与dst.put(src, off, len)具有完全相同的效果除了它首先检查这个缓冲区中是否有足够的空间,并且它可能更有效率。for (int i = off; i < off + len; i++) dst.put(a[i]);- 参数
-
src- 要从中读取int的数组 -
offset- 要读取的第一个int的数组中的偏移量; 必须是非负数,不得大于array.length -
length- 要从给定数组读取的int数; 必须是非负数,不得大于array.length - offset - 结果
- 这个缓冲区
- 异常
-
BufferOverflowException- 如果此缓冲区中没有足够的空间 -
IndexOutOfBoundsException- 如果offset和length参数的前提条件不成立 -
ReadOnlyBufferException- 如果此缓冲区为只读
-
put
public final IntBuffer put(int[] src)
相对大容量put方法(可选操作) 。此方法将给定源int数组的整个内容传输到此缓冲区。 对这种
dst.put(a)形式的方法的调用与调用的方式完全相同dst.put(a, 0, a.length)- 参数
-
src- 源数组 - 结果
- 这个缓冲区
- 异常
-
BufferOverflowException- 如果此缓冲区中没有足够的空间 -
ReadOnlyBufferException- 如果这个缓冲区是只读的
-
hasArray
public final boolean hasArray()
告诉这个缓冲区是否由可访问的int数组支持。如果此方法返回
true则可以安全地调用array和arrayOffset方法。
-
array
public final int[] array()
- Specified by:
-
array在Buffer - 结果
- 支持这个缓冲区的数组
- 异常
-
ReadOnlyBufferException- 如果此缓冲区由数组支持但是只读 -
UnsupportedOperationException- 如果此缓冲区未由可访问阵列支持
-
arrayOffset
public final int arrayOffset()
返回该缓冲区的缓冲区的第一个元素的背衬数组中的偏移量(可选操作) 。如果此缓冲区由数组支持,则缓冲区p对应于数组索引p +
arrayOffset()。在调用此方法之前调用
hasArray方法,以确保此缓冲区具有可访问的后台阵列。- Specified by:
-
arrayOffset在Buffer - 结果
- 缓冲区的第一个元素的缓冲区数组中的偏移量
- 异常
-
ReadOnlyBufferException- 如果此缓冲区由数组支持但是只读 -
UnsupportedOperationException- 如果此缓冲区未由可访问阵列支持
-
position
public final IntBuffer position(int newPosition)
设置这个缓冲区的位置。 如果标记被定义并且大于新位置,则它被丢弃。
-
limit
public final IntBuffer limit(int newLimit)
设置此缓冲区的限制。 如果位置大于新的限制,那么它被设置为新的限制。 如果标记被定义并且大于新限制,则它被丢弃。
-
reset
public final IntBuffer reset()
将此缓冲区的位置重置为先前标记的位置。调用此方法既不会更改也不丢弃该标记的值。
-
clear
public final IntBuffer clear()
清除此缓冲区。 位置设置为零,限制设置为容量,标记被丢弃。在使用一系列通道读取或放置操作填充此缓冲区之前调用此方法。 例如:
buf.clear(); // Prepare buffer for reading in.read(buf); // Read data
该方法实际上并不会清除缓冲区中的数据,而是将其命名为它的确因为它最常用于情况也是如此。
-
flip
public final IntBuffer flip()
翻转这个缓冲区。 该限制设置为当前位置,然后将该位置设置为零。 如果标记被定义,则它被丢弃。在通道读取或放置操作的序列之后,调用此方法来准备一系列通道写入或相对获取操作。 例如:
buf.put(magic); // Prepend header in.read(buf); // Read data into rest of buffer buf.flip(); // Flip buffer out.write(buf); // Write header + data to channel
-
rewind
public final IntBuffer rewind()
倒带这个缓冲区。 位置设置为零,标记被丢弃。在通道写入或获取操作的序列之前调用此方法,假设已经设置了相应的限制。 例如:
out.write(buf); // Write remaining data buf.rewind(); // Rewind buffer buf.get(array); // Copy data into array
-
compact
public abstract IntBuffer compact()
压缩此缓冲区(可选操作) 。缓冲区当前位置与其限制(如果有的话)之间的int被复制到缓冲区的开头。 也就是说,索引p =
position()处的int被复制到索引零,索引p + 1处的int被复制到索引1,等等,直到索引limit()的int被复制到索引n =limit()-1- p 。 然后将缓冲区的位置设置为n + 1,并将其限制设置为其容量。 标记如果被定义,则被丢弃。缓冲区的位置设置为复制的int数,而不是为零,因此可以通过调用另一个相对put方法来立即调用此方法。
- 结果
- 这个缓冲区
- 异常
-
ReadOnlyBufferException- 如果此缓冲区是只读的
-
isDirect
public abstract boolean isDirect()
告诉这个int缓冲区是否直接。
-
hashCode
public int hashCode()
返回此缓冲区的当前哈希码。int缓冲区的哈希码仅取决于其剩余的元素; 也就是说,元素从
position()直到并包括元素在limit()-1。因为缓冲区哈希码是内容依赖的,所以使用缓冲区作为哈希映射或类似数据结构中的密钥是不合适的,除非知道它们的内容不会改变。
- 重写:
-
hashCode在Object - 结果
- 这个缓冲区的当前哈希码
- 另请参见:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
equals
public boolean equals(Object ob)
告诉这个缓冲区是否等于另一个对象。两个int缓冲区相等,如果只有
它们具有相同的元素类型,
他们有相同数量的剩余元素,和
独立于其起始位置的剩余元素的两个序列是相等的。
int缓冲区不等于任何其他类型的对象。
- 重写:
-
equals在Object - 参数
-
ob- 要比较此缓冲区的对象 - 结果
-
true如果,且仅当此缓冲区等于给定对象时 - 另请参见:
-
Object.hashCode(),HashMap
-
compareTo
public int compareTo(IntBuffer that)
将此缓冲区与另一个缓冲区进通过将字母顺序的剩余元素的序列进行比较来比较两个int缓冲区,而不考虑其相应缓冲区内每个序列的起始位置。 对
int元素进行比较,仿佛通过调用Integer.compare(int,int)。int缓冲区不能与任何其他类型的对象相媲美。
- Specified by:
-
compareTo在接口Comparable<IntBuffer> - 参数
-
that- 要比较的对象。 - 结果
- 负整数,零或正整数,因为此缓冲区小于,等于或大于给定的缓冲区
-
order
public abstract ByteOrder order()
检索此缓冲区的字节顺序。通过分配或通过包装现有的
int阵列创建的int缓冲区的字节顺序是底层硬件的native order。 创建为字节缓冲区的view的int缓冲区的字节顺序是创建视图时的字节缓冲区的字节顺序。- 结果
- 这个缓冲区的字节顺序
-
-