Arrays.binarySearch(byte[], int, int, byte) in Java

Arrays.binarySearch(byte[], int, int, byte): This method is available in java.util.Arrays class of Java. 

Syntax:

int java.util.Arrays.binarySearch(byte[] a, int fromIndex, int toIndex, byte key)

This method takes four arguments one of type byte array and two are of type int and one of type byte as its parameters. This method searches a range of the specified array of bytes for the specified.

Note: The range must be sorted.

Parameters: Four parameters are required for this method.

a: the array to be searched.

fromIndex: the index of the first element (inclusive) to be searched.

toIndex: the index of the last element (exclusive) to be searched.

key: the value to be searched for.

Returns: index of the search key, if it is contained in the array within the specified range; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the array: the index of the first element in the range greater than the key, or toIndex if all elements in the range are less than the specified key.

Throws:

1. IllegalArgumentException - if fromIndex > toIndex.

2. ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length.

Approach 1: When no exceptions

Java

import java.util.Arrays;

public class ArraysbinarySearchbyteRange {
    public static void main(String[] args) {

        int fromIndex = 2, toIndex = 4;
        // for byte type
        byte byteArray[] = { 1, 2, 4, 5, 6 };
        byte byteKey = 4;

        // to ensure array is sorted
        Arrays.sort(byteArray);

        System.out.println(Arrays.binarySearch(byteArray,
                  fromIndex, toIndex, byteKey));
    }
}

Output:

2

Approach 2: IllegalArgumentException 

Java

import java.util.Arrays;

public class ArraysbinarySearchbyteRange {
    public static void main(String[] args) {

        int fromIndex = 5, toIndex = 4;
        // for byte type
        byte byteArray[] = { 1, 2, 4, 5, 6 };
        byte byteKey = 4;

        // to ensure array is sorted
        Arrays.sort(byteArray);

        System.out.println(Arrays.binarySearch(byteArray, 
                           fromIndex, toIndex, byteKey));
    }
}

Output:

Exception in thread "main" java.lang.IllegalArgumentException: fromIndex(5) > toIndex(4)
	at java.base/java.util.Arrays.rangeCheck(Arrays.java:718)
	at java.base/java.util.Arrays.binarySearch(Arrays.java:1938)
	

Approach 3: ArrayIndexOutOfBoundsException 

Java

import java.util.Arrays;

public class ArraysbinarySearchbyteRange {
    public static void main(String[] args) {

        int fromIndex = 2, toIndex = 6;
        // for byte type
        byte byteArray[] = { 1, 2, 4, 5, 6 };
        byte byteKey = 4;

        // to ensure array is sorted
        Arrays.sort(byteArray);

        System.out.println(Arrays.binarySearch(byteArray, 
                       fromIndex, toIndex, byteKey));
    }
}

Output:

Exception in thread "main" java.lang.ArrayIndexOutOfBoundsException: Array index out of range: 6
	at java.base/java.util.Arrays.rangeCheck(Arrays.java:725)
	at java.base/java.util.Arrays.binarySearch(Arrays.java:1938)