java.util.Arrays.binarySearch(T[] a, T key, int fromIndex, int toIndex, Comparator<? super T>


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 -- 這是用來對陣列進行排序的比較。 null值指示該元素的自然順序應該被使用。

返回值

此方法返回搜尋鍵的索引,如果它被包含在指定範圍內的陣列中;否則,( - (插入點) - 1)。插入點被定義為將鍵插入陣列的那一點:在於此鍵,則為toIndex更大,如果在該範圍內的所有元素都小於指定的鍵範圍的第一個元素的索引。

異常

  • ClassCastException -- 如果範圍包含不可相互比較使用指定的比較,或者搜尋鍵是沒有可比性使用此比較範圍內的元素的元素。

  • IllegalArgumentException -- 如果 fromIndex > toIndex

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

例子

下面的範例演示java.util.Arrays.binarySearch(super,index)方法的用法。

package com.yiibai;

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