ByteBuffer allocateDirect() method in Java with Examples

The allocateDirect() method of java.nio.ByteBuffer class is used Allocates a new direct byte buffer.

The new buffer’s position will be zero, its limit will be its capacity, its mark will be undefined, and each of its elements will be initialized to zero. Whether or not it has a backing array is unspecified.

This method is 25%-75% faster than allocate() method.

Syntax:

public static ByteBuffer allocateDirect(int capacity)

Parameters: This method takes capacity, in bytes, as parameter.

Return Value: This method returns the new byte buffer.

Exception: This method throws IllegalArgumentException, If the capacity is a negative integer.

Below are the examples to illustrate the allocateDirect() method:

Examples 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java program to demonstrate
// allocateDirect() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // Declaring the capacity of the ByteBuffer
        int capacity = 4;
  
        // Creating the ByteBuffer
        try {
  
            // creating object of ByteBuffer
            // and allocating size capacity
            ByteBuffer bb = ByteBuffer.allocateDirect(capacity);
  
            // creating byte array of size capacity
            byte[] value = { 20, 30, 40, 50 };
  
            // wrap the byte array into ByteBuffer
            bb = ByteBuffer.wrap(value);
  
            // print the ByteBuffer
            System.out.println("Direct ByteBuffer:  "
                               + Arrays.toString(bb.array()));
  
            // print the state of the buffer
            System.out.print("\nState of the ByteBuffer : ");
            System.out.println(bb.toString());
        }
  
        catch (IllegalArgumentException e) {
            System.out.println("Exception thrown : " + e);
        }
  
        catch (ReadOnlyBufferException e) {
            System.out.println("Exception thrown : " + e);
        }
    }
}

chevron_right


Output:

Direct ByteBuffer:  [20, 30, 40, 50]

State of the ByteBuffer : java.nio.HeapByteBuffer[pos=0 lim=4 cap=4]

Examples 2: To show IllegalArgumentException

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java program to demonstrate
// allocateDirect() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // Declaring the capacity
        // with negative value
        int capacity = -4;
  
        // Creating the ByteBuffer
        try {
  
            // creating object of ByteBuffer
            // and allocating size capacity
  
            System.out.println("Trying to allocate"
                               + " negative value in ByteBuffer");
            ByteBuffer bb = ByteBuffer.allocateDirect(capacity);
  
            // creating byte array of size capacity
            byte[] value = { 20, 30, 40, 50 };
  
            // wrap the byte array into ByteBuffer
            bb = ByteBuffer.wrap(value);
  
            // print the ByteBuffer
            System.out.println("Direct ByteBuffer:  "
                               + Arrays.toString(bb.array()));
  
            // print the state of the buffer
            System.out.print("\nState of the ByteBuffer : ");
            System.out.println(bb.toString());
        }
  
        catch (IllegalArgumentException e) {
            System.out.println("Exception thrown : " + e);
        }
  
        catch (ReadOnlyBufferException e) {
            System.out.println("Exception thrown : " + e);
        }
    }
}

chevron_right


Output:

Trying to allocate negative value in ByteBuffer
Exception thrown : java.lang.IllegalArgumentException: Negative capacity: -4


My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.