org.apache.tools.ant.util

Class CollectionUtils

public class CollectionUtils extends Object

A set of helper methods related to collection manipulation.

Since: Ant 1.5

Nested Class Summary
static classCollectionUtils.EmptyEnumeration
An empty enumeration.
Field Summary
static ListEMPTY_LIST
Collections.emptyList() is Java5+.
Method Summary
static Enumerationappend(Enumeration e1, Enumeration e2)
Append one enumeration to another.
static CollectionasCollection(Iterator iter)
Returns a collection containing all elements of the iterator.
static EnumerationasEnumeration(Iterator iter)
Adapt the specified Iterator to the Enumeration interface.
static IteratorasIterator(Enumeration e)
Adapt the specified Enumeration to the Iterator interface.
static booleanequals(Vector v1, Vector v2)
Please use Vector.equals() or List.equals().
static booleanequals(Dictionary d1, Dictionary d2)
Dictionary does not have an equals.
static StringflattenToString(Collection c)
Creates a comma separated list of all values held in the given collection.
static intfrequency(Collection c, Object o)
Counts how often the given Object occurs in the given collection using equals() for comparison.
static voidputAll(Dictionary m1, Dictionary m2)
Dictionary does not know the putAll method.

Field Detail

EMPTY_LIST

public static final List EMPTY_LIST
Collections.emptyList() is Java5+.

Method Detail

append

public static Enumeration append(Enumeration e1, Enumeration e2)
Append one enumeration to another. Elements are evaluated lazily.

Parameters: e1 the first enumeration. e2 the subsequent enumeration.

Returns: an enumeration representing e1 followed by e2.

Since: Ant 1.6.3

asCollection

public static Collection asCollection(Iterator iter)
Returns a collection containing all elements of the iterator.

Since: Ant 1.8.0

asEnumeration

public static Enumeration asEnumeration(Iterator iter)
Adapt the specified Iterator to the Enumeration interface.

Parameters: iter the Iterator to adapt.

Returns: an Enumeration.

asIterator

public static Iterator asIterator(Enumeration e)
Adapt the specified Enumeration to the Iterator interface.

Parameters: e the Enumeration to adapt.

Returns: an Iterator.

equals

public static boolean equals(Vector v1, Vector v2)

Deprecated: since 1.6.x.

Please use Vector.equals() or List.equals().

Parameters: v1 the first vector. v2 the second vector.

Returns: true if the vectors are equal.

Since: Ant 1.5

equals

public static boolean equals(Dictionary d1, Dictionary d2)

Deprecated: since 1.6.x.

Dictionary does not have an equals. Please use Map.equals().

Follows the equals contract of Java 2's Map.

Parameters: d1 the first directory. d2 the second directory.

Returns: true if the directories are equal.

Since: Ant 1.5

flattenToString

public static String flattenToString(Collection c)
Creates a comma separated list of all values held in the given collection.

Since: Ant 1.8.0

frequency

public static int frequency(Collection c, Object o)
Counts how often the given Object occurs in the given collection using equals() for comparison.

Since: Ant 1.8.0

putAll

public static void putAll(Dictionary m1, Dictionary m2)

Deprecated: since 1.6.x.

Dictionary does not know the putAll method. Please use Map.putAll().

Parameters: m1 the to directory. m2 the from directory.

Since: Ant 1.6