public
class
CollectionUtil
extends Object| java.lang.Object | |
| ↳ | com.pnfsoftware.jeb.util.collect.CollectionUtil |
Class Overview
Convenience methods for Java Collection collections, in particular, List lists.
Summary
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| CollectionUtil() | |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| static <T, K extends Comparable<K>> T |
binarySearch(List<T> list, K key, IExtractor<T, K> extractor)
Perform a binary search in an ordered list.
| ||||||||||
| static <T, K extends Comparable<K>> int |
binarySearchEx(List<T> list, K key, IExtractor<T, K> extractor, Comparator<K> cc)
Perform a binary search in an ordered list.
| ||||||||||
| static <T> boolean | compare(Collection<? extends T> c1, Collection<? extends T> c2, boolean sorted) | ||||||||||
| static <T> boolean | compareByReference(Collection<? extends T> c1, Collection<? extends T> c2, boolean sorted) | ||||||||||
| static boolean |
contains(Collection<?> c, Object v)
Safely check if an object is present within a collection.
| ||||||||||
| static boolean |
containsNonNull(Iterable<?> c)
Determine if the given iterable contains one or more non-null elements.
| ||||||||||
| static boolean |
containsNull(Iterable<?> c)
Determine if the given iterable contains one or more null elements.
| ||||||||||
| static <T> boolean |
containsReference(Collection<T> c, T o)
Determine if the collection contains the object reference (differs from
contains(Object) by checking reference equality == instead
of equals(Object) equality) | ||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Public Constructors
public CollectionUtil ()
Public Methods
public static T binarySearch (List<T> list, K key, IExtractor<T, K> extractor)
Perform a binary search in an ordered list.
Parameters
| list | a list of ordered items |
|---|---|
| key | the ordering key for the items. |
| extractor | key extractor |
Returns
- the element, null if not found
public static int binarySearchEx (List<T> list, K key, IExtractor<T, K> extractor, Comparator<K> cc)
Perform a binary search in an ordered list.
Parameters
| list | a list of ordered items |
|---|---|
| key | the ordering key for the items. |
| extractor | key extractor |
Returns
- the zero+ index of the found element; else, the negative insertion index of the ghost element
public static boolean compare (Collection<? extends T> c1, Collection<? extends T> c2, boolean sorted)
public static boolean compareByReference (Collection<? extends T> c1, Collection<? extends T> c2, boolean sorted)
public static boolean contains (Collection<?> c, Object v)
Safely check if an object is present within a collection.
Parameters
| c | collection, potentially null |
|---|---|
| v | object, potentially null |
Returns
- true IFF the object is contained in the collection
public static boolean containsNonNull (Iterable<?> c)
Determine if the given iterable contains one or more non-null elements.
public static boolean containsNull (Iterable<?> c)
Determine if the given iterable contains one or more null elements.
public static boolean containsReference (Collection<T> c, T o)
Determine if the collection contains the object reference (differs from
contains(Object) by checking reference equality == instead
of equals(Object) equality)
Parameters
| c | collection to loop into |
|---|---|
| o | element whose presence in this collection is to be tested |
Returns
- true if the collection contains the specified element