Java ByteBuffer putLong()方法及示例
putLong(int value)
java.nio.ByteBuffer 类的 putLong(int value) 方法用于将包含给定长值的8个字节,按照当前的字节顺序,写到这个缓冲区的当前位置,然后将位置递增8。
语法
public abstract ByteBuffer putLong(long value)
Java
参数: 该方法接收要写入的长值。
返回值: 该方法返回这个缓冲区。
异常: 该方法会抛出以下异常。
- BufferOverflowException- 如果这个缓冲区的当前位置不小于它的极限值。
- ReadOnlyBufferException- 如果这个缓冲区是只读的。
下面是一些例子来说明putLong(long value)方法。
例1 :
// Java program to demonstrate
// putLong() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 24;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putLong() method
bb.putLong(23)
.putLong(24)
.putLong(30)
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 8; i++)
System.out.print(bb.getLong() + " ");
System.out.print("]");
}
catch (BufferOverflowException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
Java
输出
Original ByteBuffer: [ 23 24 30 ]
Java
例2: 为了证明BufferOverflowException。
// Java program to demonstrate
// putLong() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 24;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putLong() method
bb.putLong(23)
.putLong(24)
.putLong(30)
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 8; i++)
System.out.print(bb.getLong() + " ");
System.out.print("]");
// putting the value in ByteBuffer
// using putLong() method
bb.putLong(234);
}
catch (BufferOverflowException e) {
System.out.println("\n\nbuffer's current position"
+ " is not smaller than its limit");
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
Java
输出
Original ByteBuffer: [ 23 24 30 ]
buffer's current position is not smaller than its limit
Exception throws : java.nio.BufferOverflowException
Java
实例3: 为了证明ReadOnlyBufferException。
// Java program to demonstrate
// putLong() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 24;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putLong() method
bb.putLong(23)
.putLong(24)
.putLong(30)
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 8; i++)
System.out.print(bb.getLong() + " ");
System.out.print("]");
// Creating a read-only copy of ByteBuffer
// using asReadOnlyBuffer() method
ByteBuffer bb1 = bb.asReadOnlyBuffer();
System.out.println("\n\nTrying to put the long value"
+ " in read-only buffer");
// putting the value in readonly ByteBuffer
// using putLong() method
bb1.putLong(234);
}
catch (BufferOverflowException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
Java
输出
Original ByteBuffer: [ 23 24 30 ]
Trying to put the long value in read only buffer
Exception throws : java.nio.ReadOnlyBufferException
Java
putLong(int index, long value)
java.nio.ByteBuffer类的putLong(int index, long value)方法用于将包含给定的8个字节的值,按照当前的字节顺序,写到这个缓冲区的给定索引处。
语法
public abstract ByteBuffer putLong(int index, long value)
Java
参数: 该方法接受以下参数作为参数。
- index : 将被写入的字节的索引
- value : 要写入的int值
返回值 :该方法返回这个缓冲区。
异常: 该方法会抛出以下异常。
- IndexOutOfBoundsException- 如果索引为负数或不小于缓冲区的极限值。
- ReadOnlyBufferException- 如果这个缓冲区是只读的。
下面是一些例子来说明putLong(int index, long value)方法。
例子1 :
// Java program to demonstrate
// putLong() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 24;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putLong() at index 0
bb.putLong(0, 23);
// putting the value in ByteBuffer
// using putLong() at index 8
bb.putLong(8, 34);
// putting the value in ByteBuffer
// using putLong() at index 16
bb.putLong(16, 27);
// rewinding the ByteBuffer
bb.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 8; i++)
System.out.print(bb.getLong() + " ");
System.out.print("]\n");
}
catch (IndexOutOfBoundsException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
Java
输出
Original ByteBuffer: [ 23 34 27 ]
Java
例2: 演示IndexOutOfBoundsException。
// Java program to demonstrate
// putLong() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 24;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putLong() at index 0
bb.putLong(0, 23);
// putting the value in ByteBuffer
// using putLong() at index 8
bb.putLong(8, 34);
// putting the value in ByteBuffer
// using putLong() at index 16
bb.putLong(16, 27);
// rewinding the ByteBuffer
bb.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 8; i++)
System.out.print(bb.getLong() + " ");
System.out.print("]\n");
// putting the value in ByteBuffer
// using putInt() at index -1
bb.putInt(-1, 45);
}
catch (IndexOutOfBoundsException e) {
System.out.println("\nindex is negative or not smaller "
+ "than the buffer's limit");
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
Java
输出
Original ByteBuffer: [ 23 34 27 ]
index is negative or not smaller than the buffer's limit
Exception throws : java.lang.IndexOutOfBoundsException
Java
例3: 演示ReadOnlyBufferException。
// Java program to demonstrate
// putLong() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 24;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// Creating a read-only copy of ByteBuffer
// using asReadOnlyBuffer() method
ByteBuffer bb1 = bb.asReadOnlyBuffer();
System.out.println("Trying to put the long value"
+ " in read-only buffer");
// putting the value in readonly ByteBuffer
// using putLong() method
bb1.putLong(0, 23);
}
catch (IndexOutOfBoundsException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
Java
输出
Trying to put the long value in read only buffer
Exception throws : java.nio.ReadOnlyBufferException
Java
参考资料
- https://docs.oracle.com/javase/9/docs/api/java/nio/ByteBuffer.html#putLong-long-
- https://docs.oracle.com/javase/9/docs/api/java/nio/ByteBuffer.html#putLong-int-long-