wrap(char[ ] array)
The wrap() method of java.nio.CharBuffer Class is used to wrap a character array into a buffer. The new buffer will be backed by the given char array. As a consequence, any modifications to the buffer will cause the array to be modified and vice versa. The new buffer’s capacity is determined by array.length, its position will be zero, and its mark will be undefined. Its backing array will be the given array, and its array offset will be zero.
Syntax:
public static CharBuffer wrap(char[] array)
Parameters: This method accepts an array as a parameter which will back this buffer.
Return Value: This method returns the new char buffer.
Below are the examples to illustrate the wrap() method:
Example-1:
// Java program to demonstrate// wrap() method  import java.nio.*;import java.util.*;  public class GFG {    public static void main(String[] args)    {          // Declare and initialize the char array        char[] cbb = { 'a', 'b', 'c' };          // print the char array length        System.out.println("Array length : " + cbb.length);          // print the char array element        System.out.println("\nArray element : "                           + Arrays.toString(cbb));          // wrap the char array into charBuffer        // using wrap() method        CharBuffer charBuffer = CharBuffer.wrap(cbb);          // Rewind the intbuffer        charBuffer.rewind();          // print the char buffer        System.out.println("\ncharBuffer : "                           + Arrays.toString(charBuffer.array()));          // print the CharBuffer capacity        System.out.println("\ncharbuffer capacity : "                           + charBuffer.capacity());          // print the CharBuffer position        System.out.println("\ncharbuffer position: "                           + charBuffer.position());    }} |
Output:
Array length : 3 Array element : [a, b, c] charBuffer : [a, b, c] charbuffer capacity : 3 charbuffer position: 0
wrap(char[ ] array, int offset, int length)
The new buffer will be backed by the given char array. As a consequence, any modifications to the buffer will cause the array to be modified and vice versa. The new buffer’s capacity is determined by array.length, its position will be offset, its limit will be offset + length, and its mark will be undefined. Its backing array will be the given array, and its array offset will be zero.
Syntax:
public static CharBuffer wrap(char[ ] array, int offset, int length)
Parameters: This method takes following parameters:
- array: The array that will back the new buffer.
- offset: The offset of the subarray to be used; must be non-negative and no larger than array.length. The new buffer’s position will be set to this value.
- length: The length of the subarray to be used; must be non-negative and no larger than array.length – offset. The new buffer’s limit will be set to offset + length.
Return Value: This method returns the new char buffer.
Throws: This method throws the IndexOutOfBoundsException(If the preconditions on the offset and length parameters do not hold) .
Below are the examples to illustrate the wrap() method:
Example-1:
// Java program to demonstrate// wrap() method  import java.nio.*;import java.util.*;  public class GFG {      public static void main(String[] args)    {          // Declare and initialize the char array        char[] cbb = { 'a', 'b', 'c' };          // print the char array length        System.out.println("Array length : " + cbb.length);          // print the char array element        System.out.println("\nArray element : "                           + Arrays.toString(cbb));          // wrap the char array into charBuffer        // using wrap() method        CharBuffer charBuffer = CharBuffer.wrap(cbb, 0, cbb.length);        // Rewind the intbuffer        charBuffer.rewind();          // print the char buffer        System.out.println("\ncharBuffer : "                           + Arrays.toString(charBuffer.array()));          // print the CharBuffer capacity        System.out.println("\ncharbuffer capacity : "                           + charBuffer.capacity());          // print the CharBuffer position        System.out.println("\ncharbuffer position: "                           + charBuffer.position());    }} |
Output:
Array length : 3 Array element : [a, b, c] charBuffer : [a, b, c] charbuffer capacity : 3 charbuffer position: 0
Examples 2: To demonstrate NullPointerException
// Java program to demonstrate// wrap() method  import java.nio.*;import java.util.*;  public class GFG {      public static void main(String[] args)    {          // Declare and initialize the float array        char[] cbb = { 'a', 'b', 'c' };          // print the char array length        System.out.println("Array length : " + cbb.length);          // print the char array element        System.out.println("\nArray element : " + Arrays.toString(cbb));          try {            // wrap the char array into charBuffer            // using wrap() method            System.out.println("\nHere "                               + "offset and length does not hold"                               + " the required condition ");            CharBuffer charBuffer = CharBuffer.wrap(cbb, 1, cbb.length);              // Rewind the intbuffer            charBuffer.rewind();              // print the char buffer            System.out.println("\ncharBuffer : "                               + Arrays.toString(charBuffer.array()));              // print the CharBuffer capacity            System.out.println("\ncharbuffer capacity : "                               + charBuffer.capacity());              // print the CharBuffer position            System.out.println("\ncharbuffer position: "                               + charBuffer.position());        }        catch (IndexOutOfBoundsException e) {            System.out.println("Exception throws: " + e);        }    }} |
Output:
Array length : 3 Array element : [a, b, c] Here offset and length does not hold the required condition Exception throws: java.lang.IndexOutOfBoundsException
