Java中的 ByteBuffer putChar() 方法及示例
putChar（字符值）
Java.nio.ByteBuffer类的putChar(char value)方法用于将包含给定 char 值的两个字节以当前字节顺序写入该缓冲区的当前位置，然后将该位置加 2。
句法：
public abstract ByteBuffer putChar(char value)参数：此方法采用要写入的 char 值。
返回值：此方法返回此缓冲区。
异常：此方法抛出以下异常：
- BufferOverflowException-如果此缓冲区的当前位置不小于其限制
- ReadOnlyBufferException-如果此缓冲区是只读的
下面是说明 putChar(char value) 方法的示例：
示例 1：
// Java program to demonstrate
// putChar() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putChar() method
bb.putChar('a')
.putChar('b')
.putChar('c')
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getChar() + " ");
System.out.print("]");
}
catch (BufferOverflowException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出：
Original ByteBuffer: [ a b c ]
示例 2：演示 BufferOverflowException。
// Java program to demonstrate
// putChar() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putChar() method
bb.putChar('a')
.putChar('b')
.putChar('c')
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getChar() + " ");
System.out.print("]\n\n");
// putting the value in ByteBuffer
// using putChar() method
bb.putChar('d');
}
catch (BufferOverflowException e) {
System.out.println("buffer's current position"
+ " is not smaller than"
+ " its limit");
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出：
Original ByteBuffer: [ a b c ]
buffer's current position is not smaller than its limit
Exception throws : java.nio.BufferOverflowException
示例 3：演示 ReadOnlyBufferException。
// Java program to demonstrate
// putChar() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putChar() method
bb.putChar('a')
.putChar('b')
.putChar('c')
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getChar() + " ");
System.out.print("]\n");
// Creating a read-only copy of ByteBuffer
// using asReadOnlyBuffer() method
ByteBuffer bb1 = bb.asReadOnlyBuffer();
System.out.println("\nTrying to put the char value"
+ " in read-only buffer");
// putting the value in readonly ByteBuffer
// using putChart() method
bb1.putChar('d');
}
catch (BufferOverflowException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出：
Original ByteBuffer: [ a b c ]
Trying to put the char value in read-only buffer
Exception throws : java.nio.ReadOnlyBufferException
putChar（整数索引，字符值）
Java.nio.ByteBuffer 类的 putChar(int index, char value) 方法用于将包含给定 char 值的两个字节以当前字节顺序写入该缓冲区中给定索引处。
句法：
public abstract ByteBuffer putChar(int index, char value)参数：此方法采用以下参数作为参数：
- index ：将写入字节的索引
- value : 要写入的 char 值
返回值：此方法返回此缓冲区。
异常：此方法抛出以下异常：
- IndexOutOfBoundsException-如果 index 为负数或不小于缓冲区的限制
- ReadOnlyBufferException-如果此缓冲区是只读的
以下是说明 putChar(int index, char value) 方法的示例：
示例 1：
// Java program to demonstrate
// putChar() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putChar() at index 0
bb.putChar(0, 'a');
// putting the value in ByteBuffer
// using putChar() at index 2
bb.putChar(2, 'b');
// putting the value in ByteBuffer
// using putChar() at index 1
bb.putChar(4, 'c');
// rewinding the ByteBuffer
bb.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getChar() + " ");
System.out.print("]\n");
}
catch (IndexOutOfBoundsException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出：
Original ByteBuffer: [ a b c ]
示例 2：演示 IndexOutOfBoundsException。
// Java program to demonstrate
// putChar() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putChar() at index 0
bb.putChar(0, 'a');
// putting the value in ByteBuffer
// using putChar() at index 2
bb.putChar(2, 'b');
// putting the value in ByteBuffer
// using putChar() at index 1
bb.putChar(4, 'c');
// rewinding the ByteBuffer
bb.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getChar() + " ");
System.out.print("]\n");
// putting the value in ByteBuffer
// using put() at index -1
bb.putChar(-1, 'd');
}
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);
}
}
}
输出：
Original ByteBuffer: [ a b c ]
index is negative or not smaller than the buffer's limit
Exception throws : java.lang.IndexOutOfBoundsException
示例 3：演示 ReadOnlyBufferException。
// Java program to demonstrate
// putChar() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// 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 byte value"
+ " in read-only buffer");
// putting the value in readonly ByteBuffer
// using putChar() method
bb1.putChar(4, 'c');
}
catch (IndexOutOfBoundsException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出：
Trying to put the byte value in read-only buffer
Exception throws : java.nio.ReadOnlyBufferException
参考：
- https://docs.oracle.com/javase/9/docs/api/ Java/nio/ByteBuffer.html#putChar-char-
- https://docs.oracle.com/javase/9/docs/api/ Java/nio/ByteBuffer.html#putChar-int-char-