com.articulate.sigma

Class SetUtil

java.lang.Object

com.articulate.sigma.SetUtil

public class SetUtil
extends java.lang.Object

A utility class that defines static methods for working with Sets and other Collections.

Method Summary

Modifier and Type	Method and Description
static boolean	isEmpty(java.lang.Object obj) Returns true if obj is not a Collection (including if obj == null) or if obj is an empty Collection.
static java.lang.String	plistMatch(java.util.List<java.lang.String> plist, java.lang.String key) Returns the first String value indexed by a String regex matching key in the property list plist, else returns an empty String if no regex in plist matches key.
static void	removeByPattern(java.util.List seq, java.lang.String regex) Filters the List of Strings seq, removing all items that match the regular expression pattern regex.
static void	removeDuplicates(java.util.Collection collection) Removes duplicates from collection based on its natural comparator or equality operator.
static void	retainByPattern(java.util.List seq, java.lang.String regex) Filters the List of Strings seq, retaining only items that match the regular expression pattern regex.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

removeDuplicates

public static void removeDuplicates(java.util.Collection collection)

Removes duplicates from collection based on its natural comparator or equality operator.

Parameters:

collection - The collection from which duplicate elements are to be removed.

isEmpty

public static boolean isEmpty(java.lang.Object obj)

Returns true if obj is not a Collection (including if obj == null) or if obj is an empty Collection. Returns false if obj is a non-empty Collection.

Parameters:

obj - The Object to be tested, presumably with the expectation that it could be a Collection

Returns:

true or false

plistMatch

public static java.lang.String plistMatch(java.util.List<java.lang.String> plist,
                                          java.lang.String key)

Returns the first String value indexed by a String regex matching key in the property list plist, else returns an empty String if no regex in plist matches key.

Parameters:

plist - A property list (cf. LISP) containing an even number of Strings, which are understood to be consecutive regex/value pairs

key - A String that will be matched against the regular expressions in plist.

Returns:

A String

removeByPattern

public static void removeByPattern(java.util.List seq,
                                   java.lang.String regex)

Filters the List of Strings seq, removing all items that match the regular expression pattern regex.

Parameters:

seq - A List of Strings

regex - A regular expression pattern String that will be matched against the Strings in seq

retainByPattern

public static void retainByPattern(java.util.List seq,
                                   java.lang.String regex)

Filters the List of Strings seq, retaining only items that match the regular expression pattern regex.

Parameters:

seq - A List of Strings

regex - A regular expression pattern String that will be matched against the Strings in seq