|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectedu.stanford.nlp.util.CollectionUtils
public class CollectionUtils
Collection of useful static methods for working with Collections. Includes methods to increment counts in maps and cast list/map elements to common types.
Method Summary | ||
---|---|---|
static
|
addAll(java.util.Collection<T> collection,
java.lang.Iterable<? extends T> items)
Add all the items from an iterable to a collection. |
|
static java.util.List<java.lang.Double> |
asList(double[] a)
|
|
static java.util.List<java.lang.Integer> |
asList(int[] a)
|
|
static java.util.List<java.lang.Object> |
asList(java.lang.Object... args)
Returns a new List containing the specified objects. |
|
static
|
asSet(T[] o)
Returns a new Set containing all the objects in the specified array. |
|
static
|
compareLists(java.util.List<T> list1,
java.util.List<T> list2)
Provides a consistent ordering over lists. |
|
static
|
containsObject(java.util.Collection<T> c,
T o)
Checks whether a Collection contains a specified Object. |
|
static
|
diff(java.util.Collection<T> list1,
java.util.Collection<T> list2)
all objects in list1 that are not in list2 |
|
static
|
getIndex(java.util.List<T> l,
T o)
Returns the index of the first occurrence in the list of the specified object, using object identity (==) not equality as the criterion for object presence. |
|
static
|
getIndex(java.util.List<T> l,
T o,
int fromIndex)
Returns the index of the first occurrence after the startIndex (exclusive) in the list of the specified object, using object equals function. |
|
static
|
getListComparator()
|
|
static
|
getMapFromString(java.lang.String s,
java.lang.Class<K> keyClass,
java.lang.Class<V> valueClass,
MapFactory<K,V> mapFactory)
|
|
static
|
getNGrams(java.util.List<T> items,
int minSize,
int maxSize)
Get all sub-lists of the given list of the given sizes. |
|
static
|
getPrefixesAndSuffixes(java.util.List<T> items,
int minSize,
int maxSize,
T paddingSymbol,
boolean includePrefixes,
boolean includeSuffixes)
Get all prefix/suffix combinations from a list. |
|
static
|
intersection(java.util.Set<T> set1,
java.util.Set<T> set2)
|
|
static
|
isSubList(java.util.List<T> l1,
java.util.List<? super T> l)
Returns true iff l1 is a sublist of l (i.e., every member of l1 is in l, and for every e1 < e2 in l1, there is an e1 < e2 occurrence in l). |
|
static
|
loadCollection(java.io.File file,
java.lang.Class<T> itemClass,
java.util.Collection<T> collection)
Adds the items from the file to the collection. |
|
static
|
loadCollection(java.io.File file,
java.lang.Class<T> c,
CollectionFactory<T> cf)
|
|
static
|
loadCollection(java.lang.String fileName,
java.lang.Class<T> itemClass,
java.util.Collection<T> collection)
Adds the items from the file to the collection. |
|
static
|
loadCollection(java.lang.String filename,
java.lang.Class<T> c,
CollectionFactory<T> cf)
|
|
static
|
makeList(T e)
Returns a new List containing the given object. |
|
static
|
makeList(T e1,
T e2)
Returns a new List containing the given objects. |
|
static
|
makeList(T e1,
T e2,
T e3)
Returns a new List containing the given objects. |
|
static
|
mergeList(java.util.List<? extends T> list,
java.util.Collection<M> matched,
Function<M,Interval<java.lang.Integer>> toIntervalFunc,
Function<java.util.List<? extends T>,T> aggregator)
|
|
static
|
mergeList(java.util.List<? extends T> list,
java.util.List<? extends HasInterval<java.lang.Integer>> matched,
Function<java.util.List<? extends T>,T> aggregator)
|
|
static
|
mergeListWithSortedMatched(java.util.List<? extends T> list,
java.util.List<? extends HasInterval<java.lang.Integer>> matched,
Function<java.util.List<? extends T>,T> aggregator)
|
|
static
|
mergeListWithSortedMatchedPreAggregated(java.util.List<? extends T> list,
java.util.List<? extends T> matched,
Function<T,Interval<java.lang.Integer>> toIntervalFunc)
|
|
static
|
removeObject(java.util.List<T> l,
T o)
Removes the first occurrence in the list of the specified object, using object identity (==) not equality as the criterion for object presence. |
|
static
|
sample(java.util.List<E> l,
java.util.Random r)
|
|
static
|
sampleWithoutReplacement(java.util.Collection<E> c,
int n)
Samples without replacement from a collection. |
|
static
|
sampleWithoutReplacement(java.util.Collection<E> c,
int n,
java.util.Random r)
Samples without replacement from a collection, using your own Random number generator. |
|
static
|
sampleWithReplacement(java.util.Collection<E> c,
int n)
Samples with replacement from a collection |
|
static
|
sampleWithReplacement(java.util.Collection<E> c,
int n,
java.util.Random r)
Samples with replacement from a collection, using your own Random
number generator |
|
static
|
sorted(java.lang.Iterable<T> items)
Return the items of an Iterable as a sorted list. |
|
static
|
toList(java.lang.Iterable<T> items)
Create a list out of the items in the Iterable. |
|
static
|
toSet(java.lang.Iterable<T> items)
Create a set out of the items in the Iterable. |
|
static
|
toVerticalString(java.util.Map<K,V> m)
|
|
static
|
union(java.util.Collection<T> set1,
java.util.Collection<T> set2)
|
|
static
|
uniqueNonhashableObjects(java.util.Collection<ObjType> objects,
Function<ObjType,Hashable> customHasher)
Makes it possible to uniquify a collection of objects which are normally non-hashable. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static java.util.List<java.lang.Integer> asList(int[] a)
public static java.util.List<java.lang.Double> asList(double[] a)
public static java.util.List<java.lang.Object> asList(java.lang.Object... args)
public static <T> java.util.List<T> makeList(T e)
public static <T> java.util.List<T> makeList(T e1, T e2)
public static <T> java.util.List<T> makeList(T e1, T e2, T e3)
public static <T> java.util.Set<T> asSet(T[] o)
public static <T> java.util.Set<T> intersection(java.util.Set<T> set1, java.util.Set<T> set2)
public static <T> java.util.Collection<T> union(java.util.Collection<T> set1, java.util.Collection<T> set2)
public static <T> java.util.Collection<T> diff(java.util.Collection<T> list1, java.util.Collection<T> list2)
T
- list1
- First collectionlist2
- Second collection
public static <T> java.util.Collection<T> loadCollection(java.lang.String filename, java.lang.Class<T> c, CollectionFactory<T> cf) throws java.lang.Exception
filename
- the path to the file to load the List fromc
- the Class to instantiate each member of the List. Must have a
String constructor.
java.lang.Exception
public static <T> java.util.Collection<T> loadCollection(java.io.File file, java.lang.Class<T> c, CollectionFactory<T> cf) throws java.lang.Exception
file
- the file to load the List fromc
- the Class to instantiate each member of the List. Must have a
String constructor.
java.lang.Exception
public static <T> void loadCollection(java.lang.String fileName, java.lang.Class<T> itemClass, java.util.Collection<T> collection) throws java.lang.NoSuchMethodException, java.lang.InstantiationException, java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.io.IOException
T
- The type of the items.fileName
- The name of the file from which items should be loaded.itemClass
- The class of the items (must have a constructor that accepts a
String).collection
- The collection to which items should be added.
java.lang.NoSuchMethodException
java.lang.InstantiationException
java.lang.IllegalAccessException
java.lang.reflect.InvocationTargetException
java.io.IOException
public static <T> void loadCollection(java.io.File file, java.lang.Class<T> itemClass, java.util.Collection<T> collection) throws java.lang.NoSuchMethodException, java.lang.InstantiationException, java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.io.IOException
T
- The type of the items.file
- The file from which items should be loaded.itemClass
- The class of the items (must have a constructor that accepts a
String).collection
- The collection to which items should be added.
java.lang.NoSuchMethodException
java.lang.InstantiationException
java.lang.IllegalAccessException
java.lang.reflect.InvocationTargetException
java.io.IOException
public static <K,V> java.util.Map<K,V> getMapFromString(java.lang.String s, java.lang.Class<K> keyClass, java.lang.Class<V> valueClass, MapFactory<K,V> mapFactory) throws java.lang.ClassNotFoundException, java.lang.NoSuchMethodException, java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.InstantiationException
java.lang.ClassNotFoundException
java.lang.NoSuchMethodException
java.lang.IllegalAccessException
java.lang.reflect.InvocationTargetException
java.lang.InstantiationException
public static <T> boolean containsObject(java.util.Collection<T> c, T o)
public static <T> boolean removeObject(java.util.List<T> l, T o)
l
- The List
from which to remove the objecto
- The object to be removed.
public static <T> int getIndex(java.util.List<T> l, T o)
l
- The List
to find the object in.o
- The sought-after object.
public static <T> int getIndex(java.util.List<T> l, T o, int fromIndex)
l
- The List
to find the object in.o
- The sought-after object.fromIndex
- The start index
public static <E> java.util.Collection<E> sampleWithoutReplacement(java.util.Collection<E> c, int n)
c
- The collection to be sampled fromn
- The number of samples to take
public static <E> java.util.Collection<E> sampleWithoutReplacement(java.util.Collection<E> c, int n, java.util.Random r)
Random
number generator.
c
- The collection to be sampled fromn
- The number of samples to taker
- the random number generator
public static <E> E sample(java.util.List<E> l, java.util.Random r)
public static <E> java.util.Collection<E> sampleWithReplacement(java.util.Collection<E> c, int n)
c
- The collection to be sampled fromn
- The number of samples to take
public static <E> java.util.Collection<E> sampleWithReplacement(java.util.Collection<E> c, int n, java.util.Random r)
Random
number generator
c
- The collection to be sampled fromn
- The number of samples to taker
- the random number generator
public static <T> boolean isSubList(java.util.List<T> l1, java.util.List<? super T> l)
public static <K,V> java.lang.String toVerticalString(java.util.Map<K,V> m)
public static <T extends java.lang.Comparable<T>> int compareLists(java.util.List<T> list1, java.util.List<T> list2)
public static <C extends java.lang.Comparable<C>> java.util.Comparator<java.util.List<C>> getListComparator()
public static <T extends java.lang.Comparable<T>> java.util.List<T> sorted(java.lang.Iterable<T> items)
T
- The type of items in the Iterable.items
- The collection to be sorted.
public static <T> java.util.List<T> toList(java.lang.Iterable<T> items)
T
- The type of items in the Iterable.items
- The items to be made into a list.
public static <T> java.util.Set<T> toSet(java.lang.Iterable<T> items)
T
- The type of items in the Iterable.items
- The items to be made into a set.
public static <T> void addAll(java.util.Collection<T> collection, java.lang.Iterable<? extends T> items)
T
- The type of items in the iterable and the collectioncollection
- The collection to which the items should be added.items
- The items to add to the collection.public static <T> java.util.List<java.util.List<T>> getNGrams(java.util.List<T> items, int minSize, int maxSize)
List<String> items = Arrays.asList("a", "b", "c", "d"); System.out.println(CollectionUtils.getNGrams(items, 1, 2));would print out:
[[a], [a, b], [b], [b, c], [c], [c, d], [d]]
T
- The type of items contained in the list.items
- The list of items.minSize
- The minimum size of an ngram.maxSize
- The maximum size of an ngram.
public static <T> java.util.List<java.util.List<T>> getPrefixesAndSuffixes(java.util.List<T> items, int minSize, int maxSize, T paddingSymbol, boolean includePrefixes, boolean includeSuffixes)
List<String> items = Arrays.asList("a", "b", "c", "d"); System.out.println(CollectionUtils.getPrefixesAndSuffixes(items, 1, 2, null, true, true));would print out:
[[d], [a], [a, d], [d, c], [a, b], [a, b, c, d]]and
List<String> items2 = Arrays.asList("a"); System.out.println(CollectionUtils.getPrefixesAndSuffixes(items2, 1, 2, null, true, true));would print:
[[a], [a], [a, a], [a, null], [a, null], [a, null, a, null]]
T
- The type of items contained in the list.items
- The list of items.minSize
- The minimum length of a prefix/suffix span (should be at least 1)maxSize
- The maximum length of a prefix/suffix spanpaddingSymbol
- Symbol to be included if we run out of bounds (e.g. if items has
size 3 and we try to extract a span of length 4).includePrefixes
- whether to extract prefixesincludeSuffixes
- whether to extract suffixes
public static <T,M> java.util.List<T> mergeList(java.util.List<? extends T> list, java.util.Collection<M> matched, Function<M,Interval<java.lang.Integer>> toIntervalFunc, Function<java.util.List<? extends T>,T> aggregator)
public static <T> java.util.List<T> mergeList(java.util.List<? extends T> list, java.util.List<? extends HasInterval<java.lang.Integer>> matched, Function<java.util.List<? extends T>,T> aggregator)
public static <T> java.util.List<T> mergeListWithSortedMatched(java.util.List<? extends T> list, java.util.List<? extends HasInterval<java.lang.Integer>> matched, Function<java.util.List<? extends T>,T> aggregator)
public static <T> java.util.List<T> mergeListWithSortedMatchedPreAggregated(java.util.List<? extends T> list, java.util.List<? extends T> matched, Function<T,Interval<java.lang.Integer>> toIntervalFunc)
public static <ObjType,Hashable> java.util.Collection<ObjType> uniqueNonhashableObjects(java.util.Collection<ObjType> objects, Function<ObjType,Hashable> customHasher)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |