putChar(char value)
The
putChar(char value) method of
java.nio.ByteBuffer Class is used to write two bytes containing the given char value, in the current byte order, into this buffer at the current position, and then increments the position by two.
Syntax:
public abstract ByteBuffer putChar(char value)
Parameters: This method takes the char value to be written.
Return Value: This method returns this buffer.
Exception: This method throws the following exceptions:
- BufferOverflowException- If this buffer's current position is not smaller than its limit
- ReadOnlyBufferException- If this buffer is read-only
Below are the examples to illustrate the putChar(char value) method:
Example 1:
Output:
Original ByteBuffer: [ a b c ]
Example 2: To demonstrate BufferOverflowException.
Output:
Original ByteBuffer: [ a b c ]
buffer's current position is not smaller than its limit
Exception throws : java.nio.BufferOverflowException
Examples 3: To demonstrate ReadOnlyBufferException.
Output:
Original ByteBuffer: [ a b c ]
Trying to put the char value in read-only buffer
Exception throws : java.nio.ReadOnlyBufferException
putChar(int index, char value)
The putChar(int index, char value) method of java.nio.ByteBuffer Class is used to write two bytes containing the given char value, in the current byte order, into this buffer at the given index.
Syntax:
public abstract ByteBuffer putChar(int index, char value)
Parameters: This method takes the following arguments as a parameter:
- index: The index at which the byte will be written
- value: The char value to be written
Return Value: This method returns the this buffer.
Exception: This method throws the following exception:
- IndexOutOfBoundsException- If index is negative or not smaller than the buffer's limit
- ReadOnlyBufferException- If this buffer is read-only
Below are the examples to illustrate the putChar(int index, char value) method:
Example 1:
Output:
Original ByteBuffer: [ a b c ]
Example 2: To demonstrate IndexOutOfBoundsException.
Output:
Original ByteBuffer: [ a b c ]
index is negative or not smaller than the buffer's limit
Exception throws : java.lang.IndexOutOfBoundsException
Example 3: To demonstrate ReadOnlyBufferException.
