Java.util.Arrays.binarySearch() 方法

描述

java.util.Arrays.binarySearch(T[] a, T key, int fromIndex, int toIndex, Comparator<? super T> c) 方法使用二进制搜索算法在指定数组的范围内搜索指定对象。 在进行此调用之前,必须根据指定的比较器对范围进行升序排序。 如果未排序,则结果未定义。


声明

以下是 java.util.Arrays.binarySearch(super,index) 方法的声明

public static <T> int binarySearch(T[] a, T key, int fromIndex, int toIndex, Comparator<? super T> c)

参数

  • a − 这是要搜索的数组。

  • fromIndex − 要搜索的第一个元素(包括)的索引。

  • toIndex− 要搜索的最后一个元素的索引(不包括)。

  • key − 这是要搜索的值。

  • c − 这是排序数组的比较器。 空值表示应使用元素自然排序。


返回值

此方法返回搜索键的索引,如果它包含在指定范围内的数组中; 否则,(-(插入点)- 1)。 插入点定义为将键插入数组的点:范围中大于键的第一个元素的索引,如果范围内的所有元素都小于指定键,则为 toIndex。


异常

  • ClassCastException − 如果范围包含使用指定比较器无法相互比较的元素,或者搜索键与使用此比较器的范围内的元素不可比较。

  • IllegalArgumentException − 如果 fromIndex > toIndex

  • ArrayIndexOutOfBoundsException − 如果 fromIndex < 0 或 toIndex > a.length


示例

下面的例子展示了 java.util.Arrays.binarySearch(super,index) 方法的使用。

package com.tutorialspoint;

import java.util.Arrays;
import java.util.Comparator;

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

      // initializing unsorted short array
      Short shortArr[] = new Short[]{5, 2, 15, 52, 10};

      // use comparator as null, sorting as natural ordering
      Comparator<Short> comp = null;

      // sorting array
      Arrays.sort(shortArr, comp);

      // let us print all the elements available in list
      System.out.println("The sorted short array is:");
      for (short number : shortArr) {
         System.out.println("Number = " + number);
      }

      // entering the value to be searched 
      short searchVal = 15;

      // search between index 1 and 4
      int retVal = Arrays.binarySearch(shortArr, 1, 4, searchVal, comp);
      System.out.println("The index of element 15 is : " + retVal);

      // search between index 0 and 3, where searchVal doesn't exist
      retVal = Arrays.binarySearch(shortArr, 0, 3, searchVal, comp);
      System.out.println("The index of element 15 is : " + retVal);
   }
}

让我们编译并运行上面的程序,这将产生以下结果 −

The sorted short array is:
Number = 2
Number = 5
Number = 10
Number = 15
Number = 52
The index of element 15 is : 3
The index of element 15 is : -4