Collections.binarySearch（）是否返回與鍵完全相同的值

Question

如果我調用Collections.binarySearch(sortedList, key, compareMethod) ，則它是返回索引處的項“ x”（如果索引為正）：

1.）找到第一個key = x （如key.equals（x）所示）

要么

2.）找到的第一個值，其compareMethod(key, x) == 0

要么

3.）以上都不是嗎？

---

我的具體問題：

我有一個Point的list ，每個Point具有一個(x,y)坐標對。 我使用自定義Comparator方法compareX()以增加x坐標的順序對列表進行排序。

Point相等（ Point.equals() ）被定義為相同的x和y坐標

現在，我想對key列表進行binarySearch ，所以我調用Collections.binarySearch(list, key, compareX) -如果找到了Point ，是否保證x = key.x 和 y = key.y ，或者只是x = key.x嗎？

Answer 1

1.）找到第一個鍵= x的值（如key.equals（x）所示），或

2.）找到的第一個值，其compareMethod（key，x）== 0，或者

都不存在，如果有多個值的compareMethod(key, x) == 0 。 它將返回這些值之一，但不確定哪個值。 從JavaDoc ：

如果列表包含等於指定對象的多個元素，則不能保證將找到哪個元素。

至於問題的另一部分，如果compareMethod只比較x ，那么唯一得到的保證就是x = key.x

如果您使用compareMethod在x和y上都使用一致的比較邏輯 ，則可以保證得到x = key.x和y = key.y （如果存在）。 例如：

Comparator<Point> cmp = (p1, p2) -> {
  int cmpx = Integer.compare(p1.x, p2.x);
  if (cmpx != 0) {
    return cmpx;
  }
  return Integer.compare(p1.y, p2.y);
};

Answer 2

binarySearch方法將基於Comparator而不是equals來測試equals 。

Javadoc for Comparator引入了Comparator與equals一致的概念； 當a.equals(b)與a.compareTo(b) == 0對於a和b所有可能值相同時，兩者是一致的。 與equals不一致的Comparator應謹慎使用，並在可能的情況下避免使用。

Answer 3

在這里回答我自己的問題，收集不同答案中所說的內容，並提供明確的解釋：

如Collections.binarySearch() 源代碼所示 ， 所有比較都是使用Comparator方法完成的-因此，如果Compare(x,y) == 0 ，則x和y被視為相等。

通常，這意味着如果Collections.binarySearch()返回肯定的結果，它將是Comparator返回0的某個值的位置。如果有多個這樣的值，則該值未定義。

---

對於我的情況具體是：寫在這個問題中，調用Collections.binarySearch()會返回一些指數Point與x = key.x ，如果這樣的Point存在。

正確的解決方案是更新xCompare方法，以便比較x坐標-如果它們不相等，則返回該比較。 否則，它將比較y坐標。 這樣， Comparator將首先通過x坐標進行比較，然后（對於具有相同x任何Point ）通過y坐標進行比較。

這將導致排序和搜索，首先是x ，然后是y ，當且僅當x和y相等時，比較才返回0。