com.ibm.wala.util.collections

Class Util

java.lang.Object

com.ibm.wala.util.collections.Util

public class Util
extends Object

Miscellaneous utility functions.

Field Summary

Fields

Modifier and Type	Field and Description
static BitSet	EMPTY_BITSET The empty BitSet.
static boolean	FULLY_QUALIFIED_NAMES Generate strings with fully qualified names or not

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
static <T> void	addIfNotNull(T val, Collection<T> vals)
static <T> void	doForAll(Collection<T> c, ObjectVisitor<T> v) Perform an action for all elements in a collection.
static <S,T> Set<T>	filterByType(Iterable<S> c, Class<T> klass) Return those elements of c that are assignable to klass.
static <T> T	find(Collection<T> c, Predicate<T> p) Test whether some element of the given Collection satisfies the given Predicate.
static <T> boolean	forAll(Collection<T> c, Predicate<T> p) Test whether all elements of the given Collection satisfy the given Predicate.
static <T> boolean	forSome(Collection<T> c, Predicate<T> p) Test whether some element of the given Collection satisfies the given Predicate.
static long	getUsedMemory()
static <T> boolean	intersecting(Set<T> s1, Set<T> s2) checks if two sets have a non-empty intersection
static <T,U> List<U>	map(List<T> srcList, Function<T,U> f) Map a list: generate a new list with each element mapped.
static <T,U> Set<U>	mapToSet(Collection<T> srcSet, Function<T,U> f) Map a set: generate a new set with each element mapped.
static String	objectFieldsToString(Object obj) Write object fields to string
static int[]	realloc(int[] data, int newSize)
static String	removePackageName(String fully_qualified_name_) Remove the package name from a fully qualified class name
static String	str(Throwable thrown) Get a String representation of a Throwable.
static String	topLevelTypeString(String typeStr) given the name of a class C, returns the name of the top-most enclosing class of class C.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_BITSET

public static final BitSet EMPTY_BITSET

The empty BitSet.

FULLY_QUALIFIED_NAMES

public static final boolean FULLY_QUALIFIED_NAMES

Generate strings with fully qualified names or not

See Also:

Constant Field Values

Constructor Detail

Util

public Util()

Method Detail

str

public static String str(Throwable thrown)
                  throws IllegalArgumentException

Get a String representation of a Throwable.

Throws:

IllegalArgumentException - if thrown == null

filterByType

public static <S,T> Set<T> filterByType(Iterable<S> c,
                                        Class<T> klass)

Return those elements of c that are assignable to klass.

forSome

public static <T> boolean forSome(Collection<T> c,
                                  Predicate<T> p)
                           throws IllegalArgumentException

Test whether some element of the given Collection satisfies the given Predicate.

Throws:

IllegalArgumentException - if c == null

find

public static <T> T find(Collection<T> c,
                         Predicate<T> p)
                  throws IllegalArgumentException

Test whether some element of the given Collection satisfies the given Predicate.

Returns:

The first element satisfying the predicate; otherwise null.

Throws:

IllegalArgumentException - if c == null

forAll

public static <T> boolean forAll(Collection<T> c,
                                 Predicate<T> p)
                          throws NullPointerException

Test whether all elements of the given Collection satisfy the given Predicate.

Throws:

NullPointerException - if c == null

doForAll

public static <T> void doForAll(Collection<T> c,
                                ObjectVisitor<T> v)
                         throws IllegalArgumentException

Perform an action for all elements in a collection.

Parameters:

c - the collection

v - the visitor defining the action

Throws:

IllegalArgumentException - if c == null

map

public static <T,U> List<U> map(List<T> srcList,
                                Function<T,U> f)
                         throws IllegalArgumentException

Map a list: generate a new list with each element mapped. The new list is always an ArrayList; it would have been more precise to use reflection to create a list of the same type as 'srcList', but reflection works really slowly in some implementations, so it's best to avoid it.

Throws:

IllegalArgumentException - if srcList == null

mapToSet

public static <T,U> Set<U> mapToSet(Collection<T> srcSet,
                                    Function<T,U> f)
                             throws IllegalArgumentException

Map a set: generate a new set with each element mapped. The new set is always a HashSet; it would have been more precise to use reflection to create a set of the same type as 'srcSet', but reflection works really slowly in some implementations, so it's best to avoid it.

Throws:

IllegalArgumentException - if srcSet == null

realloc

public static int[] realloc(int[] data,
                            int newSize)
                     throws IllegalArgumentException

Throws:

IllegalArgumentException

objectFieldsToString

public static String objectFieldsToString(Object obj)
                                   throws IllegalArgumentException

Write object fields to string

Throws:

IllegalArgumentException - if obj == null

removePackageName

public static String removePackageName(String fully_qualified_name_)

Remove the package name from a fully qualified class name

intersecting

public static <T> boolean intersecting(Set<T> s1,
                                       Set<T> s2)

checks if two sets have a non-empty intersection

Returns:

true if the sets intersect; false otherwise

topLevelTypeString

public static String topLevelTypeString(String typeStr)
                                 throws IllegalArgumentException

given the name of a class C, returns the name of the top-most enclosing class of class C. For example, given A$B$C, the method returns A

Returns:

String name of top-most enclosing class

Throws:

IllegalArgumentException - if typeStr == null

addIfNotNull

public static <T> void addIfNotNull(T val,
                                    Collection<T> vals)

getUsedMemory

public static long getUsedMemory()

Returns:

the amount of memory currently being used, in bytes. Often inaccurate, but there's no better thing to do from within the JVM.