Searches the specified list for the specified object using the binary search algorithm.

package com.candidjava; import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; import java.util.List; /** * * @author karthikeyan.T * @description Searches the specified list for the specified object using the * binary search algorithm. */ public class CollectionsBinary { public static void main(String args[]) { String values[] = { "Karthik", "Hari", "Mohan", "Anand", "Vinod", "Kamal" }; List<String> list = new ArrayList<String>(Arrays.asList(values)); Collections.sort(list); System.out.println("Sorted list: [length: " + list.size() + "]"); System.out.println(list); int index = Collections.binarySearch(list, "Mohan"); System.out.println("value Mohan @ " + index); index = Collections.binarySearch(list, "J"); System.out.println("value Jagan @ " + index); } }

Sorted list: [length: 6]

[Anand, Hari, Kamal, Karthik, Mohan, Vinod]

value Mohan @ 4

value Jagan @ -3

public static <T> int binarySearch(List<? extends Comparable<? super T>> list, T key)

Searches the specified list for the specified object using the binary search algorithm. The list must be sorted into ascending order according to the natural ordering of its elements (as by the sort(List) method) prior to making this call. If it is not sorted, the results are undefined. If the list contains multiple elements equal to the specified object, there is no guarantee which one will be found.

This method runs in log(n) time for a "random access" list (which provides near-constant-time positional access). If the specified list does not implement the RandomAccess interface and is large, this method will do an iterator-based binary search that performs O(n) link traversals and O(log n) element comparisons.

Parameters:

list - the list to be searched.

key - the key to be searched for.

Returns:

the index of the search key, if it is contained in the list; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the list: the index of the first element greater than the key, or list.size() if all elements in the list are less than the specified key. Note that this guarantees that the return value will be >= 0 if and only if the key is found.

Throws:

ClassCastException - if the list contains elements that are not mutually comparable (for example, strings and integers), or the search key is not mutually comparable with the elements of the list.

Related Post