Java Arrays binarySearch() 方法

---

---

描述

Java Arrays binarySearch(Object[] a, Object key) 方法使用二分查找算法在指定的 Object 数组中搜索指定的值。在调用此方法之前，数组必须根据对象的自然顺序进行排序。如果未排序，则结果未定义。

声明

以下是 java.util.Arrays.binarySearch(Object[] a, Object key) 方法的声明

public static int binarySearch(Object[] a, Object key)

参数

• a − 要搜索的数组。

• key − 要搜索的值。

返回值

如果搜索键包含在数组中，此方法返回搜索键的索引；否则，返回 (-(插入点) - 1)。插入点是将键插入到数组中的位置：大于键的第一个元素的索引，如果数组中的所有元素都小于指定的键，则为 a.length。

异常

• ClassCastException − 如果搜索键与数组的元素不可比较。

Java Arrays binarySearch(Object[] a, int fromIndex, int toIndex, Object key) 方法

描述

Java Arrays binarySearch(Object[] a, int fromIndex, int toIndex, Object key) 方法使用二分查找算法在指定的 Object 数组的范围内搜索指定的值。在调用此方法之前，该范围必须根据对象的自然顺序进行排序。如果未排序，则结果未定义。

声明

以下是 java.util.Arrays.binarySearch(Object[] a, int fromIndex, int toIndex, Object key) 方法的声明

public static int binarySearch(Object[] a, int fromIndex, int toIndex, Object key)

参数

• a − 要搜索的数组。

• fromIndex − 要搜索的第一个元素的索引（包含）。

• toIndex − 要搜索的最后一个元素的索引（不包含）。

• key − 要搜索的值。

返回值

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

异常

• ClassCastException − 如果搜索键与数组的元素不可比较。

• IllegalArgumentException − 如果 fromIndex > toIndex

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

在 Object 数组上执行二分查找示例

以下示例显示了 Java Arrays binarySearch(Object[], key) 方法的用法。首先，我们创建了一个 Student 对象数组，对其进行排序并打印。然后对一个值执行二分查找并打印结果。

package com.tutorialspoint;
import java.util.Arrays;
public class ArrayDemo {
   public static void main(String[] args) {

      // initializing unsorted Object array
      Student studentsArr[] = new Student[]{new Student(1, "Julie"), new Student(3, "Adam"), new Student(2, "Robert")};

      // sorting array
      Arrays.sort(studentsArr);

      // let us print all the elements available in list
      System.out.println("The sorted Object array is:");
      for (Student student : studentsArr) {
         System.out.println("Student = " + student);
      }

      // entering the student to be searched
      Student searchVal = new Student(1, "Julie");
      int retVal = Arrays.binarySearch(studentsArr,searchVal);
      System.out.println("The index of student Julie is : " + retVal);
   }
}
class Student implements Comparable<Student> {
   int rollNo;
   String name;
   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }
   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }   
   @Override
   public boolean equals(Object obj) {
      Student s = (Student)obj;
      return this.rollNo == s.rollNo && this.name.equalsIgnoreCase(s.name);
   }
   @Override
   public int compareTo(Student student) {
      return this.rollNo - student.rollNo;
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

The sorted Object array is:
Student = [ 1, Julie ]
Student = [ 2, Robert ]
Student = [ 3, Adam ]
The index of student Julie is : 0

在 Object 子数组上执行二分查找示例

以下示例显示了 Java Arrays binarySearch(Object[], fromIndex, toIndex, key) 方法的用法。首先，我们创建了一个 Student 对象数组，对其进行排序并打印。然后对子数组上的值执行二分查找并打印结果。

package com.tutorialspoint;
import java.util.Arrays;
public class ArrayDemo {
   public static void main(String[] args) {

      // initializing unsorted Object array
      Student studentsArr[] = new Student[]{new Student(1, "Julie"), new Student(3, "Adam"), new Student(2, "Robert")};

      // sorting array
      Arrays.sort(studentsArr);

      // let us print all the elements available in list
      System.out.println("The sorted Object array is:");
      for (Student student : studentsArr) {
         System.out.println("Student = " + student);
      }

      // entering the object to be searched
      Student searchVal = new Student(1, "Julie");

      // entering the range of index
      int retVal = Arrays.binarySearch(studentsArr,0,1,searchVal);
      System.out.println("The index of student Julie is : " + retVal);
   }
}
class Student implements Comparable<Student> {
   int rollNo;
   String name;
   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }
   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }   
   @Override
   public boolean equals(Object obj) {
      Student s = (Student)obj;
      return this.rollNo == s.rollNo && this.name.equalsIgnoreCase(s.name);
   }
   @Override
   public int compareTo(Student student) {
      return this.rollNo - student.rollNo;
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

The sorted Object array is:
Student = [ 1, Julie ]
Student = [ 2, Robert ]
Student = [ 3, Adam ]
The index of student Julie is : 0

在 Object 数组上对不存在的对象执行二分查找示例

以下示例显示了 Java Arrays binarySearch(Object[], key) 方法的用法。首先，我们创建了一个 Student 对象数组，对其进行排序并打印。然后对数组中不存在的值执行二分查找并打印结果。

package com.tutorialspoint;
import java.util.Arrays;
public class ArrayDemo {
   public static void main(String[] args) {

      // initializing unsorted Student array
      Student studentsArr[] = new Student[]{new Student(1, "Julie"), new Student(3, "Adam"), new Student(2, "Robert")};

      // sorting array
      Arrays.sort(studentsArr);

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

      // entering the value to be searched
      Student searchVal = new Student(4, "Jene");
      int retVal = Arrays.binarySearch(studentsArr,searchVal);
      System.out.println("The index of student Jene is : " + retVal);
   }
}
class Student implements Comparable<Student> {
   int rollNo;
   String name;
   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }
   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }   
   @Override
   public boolean equals(Object obj) {
      Student s = (Student)obj;
      return this.rollNo == s.rollNo && this.name.equalsIgnoreCase(s.name);
   }
   @Override
   public int compareTo(Student student) {
      return this.rollNo - student.rollNo;
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

The sorted Student array is:
Student = [ 1, Julie ]
Student = [ 2, Robert ]
Student = [ 3, Adam ]
The index of student Jene is : -4