CollectionUtils (Apache Ant API)
Date: 2018-09-11

Package org.apache.tools.ant.util

## Class CollectionUtils

- java.lang.Object
- - org.apache.tools.ant.util.CollectionUtils

-     @Deprecated
      public class CollectionUtils
      extends java.lang.Object

  Deprecated.
  A set of helper methods related to collection manipulation.
  Since:
    Ant 1.5

- - ### Nested Class Summary

    Nested Classes
    Modifier and Type | Class | Description
    --- | --- | ---
    `static class` | `CollectionUtils.EmptyEnumeration<E>` | Deprecated.

  - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---
    `static java.util.List` | `EMPTY_LIST` | Deprecated.

  - ### Method Summary

    All Methods Static Methods Concrete Methods Deprecated Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `static <E> java.util.Enumeration<E>` | `append​(java.util.Enumeration<E> e1, java.util.Enumeration<E> e2)` | Deprecated. use Stream.concat(Collections.list(e1).stream(), Collections.list(e2).stream()) .collect(Collectors.collectingAndThen(Collectors.toList(), Collections::enumeration))
    `static <T> java.util.Collection<T>` | `asCollection​(java.util.Iterator<? extends T> iter)` | Deprecated. instantiate a list and use forEachRemaining(list::add)
    `static <E> java.util.Enumeration<E>` | `asEnumeration​(java.util.Iterator<E> iter)` | Deprecated. use Collections.enumeration()
    `static <E> java.util.Iterator<E>` | `asIterator​(java.util.Enumeration<E> e)` | Deprecated. use Collections.list(e).iterator()
    `static boolean` | `equals​(java.util.Dictionary<?,?> d1, java.util.Dictionary<?,?> d2)` | Deprecated. since 1.6.x.
    `static boolean` | `equals​(java.util.Vector<?> v1, java.util.Vector<?> v2)` | Deprecated. since 1.6.x.
    `static java.lang.String` | `flattenToString​(java.util.Collection<?> c)` | Deprecated. use stream().collect(Collectors.joining(","))
    `static int` | `frequency​(java.util.Collection<?> c, java.lang.Object o)` | Deprecated.
    `static <K,V> void` | `putAll​(java.util.Dictionary<? super K,? super V> m1, java.util.Dictionary<? extends K,? extends V> m2)` | Deprecated. since 1.6.x.

    - ### Methods inherited from class java.lang.Object

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

- - ### Field Detail

    - #### EMPTY_LIST

          @Deprecated
          public static final java.util.List EMPTY_LIST

      Deprecated.

  - ### Method Detail

    - #### equals

          @Deprecated
          public static boolean equals​(java.util.Vector<?> v1,
                                       java.util.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

          @Deprecated
          public static boolean equals​(java.util.Dictionary<?,?> d1,
                                       java.util.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

          @Deprecated
          public static java.lang.String flattenToString​(java.util.Collection<?> c)

      Deprecated.
      use stream().collect(Collectors.joining(","))
      Creates a comma separated list of all values held in the given collection.
      Parameters:
        `c` - collection to transform
      Returns:
        string representation of the collection
      Since:
        Ant 1.8.0

    - #### putAll

          @Deprecated
          public static <K,V> void putAll​(java.util.Dictionary<? super K,? super V> m1,
                                          java.util.Dictionary<? extends K,? extends V> m2)

      Deprecated.
      since 1.6.x.
      Dictionary does not know the putAll method. Please use Map.putAll().
      Type Parameters:
        `K` - type of the key
        `V` - type of the value
      Parameters:
        `m1` - the to directory.
        `m2` - the from directory.
      Since:
        Ant 1.6

    - #### append

          @Deprecated
          public static <E> java.util.Enumeration<E> append​(java.util.Enumeration<E> e1,
                                                            java.util.Enumeration<E> e2)

      Deprecated.
      use Stream.concat(Collections.list(e1).stream(), Collections.list(e2).stream()) .collect(Collectors.collectingAndThen(Collectors.toList(), Collections::enumeration))
      Append one enumeration to another. Elements are evaluated lazily.
      Type Parameters:
        `E` - element type
      Parameters:
        `e1` - the first enumeration.
        `e2` - the subsequent enumeration.
      Returns:
        an enumeration representing e1 followed by e2.
      Since:
        Ant 1.6.3

    - #### asEnumeration

          @Deprecated
          public static <E> java.util.Enumeration<E> asEnumeration​(java.util.Iterator<E> iter)

      Deprecated.
      use Collections.enumeration()
      Adapt the specified Iterator to the Enumeration interface.
      Type Parameters:
        `E` - element type
      Parameters:
        `iter` - the Iterator to adapt.
      Returns:
        an Enumeration.

    - #### asIterator

          @Deprecated
          public static <E> java.util.Iterator<E> asIterator​(java.util.Enumeration<E> e)

      Deprecated.
      use Collections.list(e).iterator()
      Adapt the specified Enumeration to the Iterator interface.
      Type Parameters:
        `E` - element type
      Parameters:
        `e` - the Enumeration to adapt.
      Returns:
        an Iterator.

    - #### asCollection

          @Deprecated
          public static <T> java.util.Collection<T> asCollection​(java.util.Iterator<? extends T> iter)

      Deprecated.
      instantiate a list and use forEachRemaining(list::add)
      Returns a collection containing all elements of the iterator.
      Type Parameters:
        `T` - element type
      Parameters:
        `iter` - the Iterator to convert
      Returns:
        the collection
      Since:
        Ant 1.8.0

    - #### frequency

          @Deprecated
          public static int frequency​(java.util.Collection<?> c,
                                      java.lang.Object o)

      Deprecated.
      Counts how often the given Object occurs in the given collection using equals() for comparison.
      Parameters:
        `c` - collection in which to search
        `o` - object to search
      Returns:
        frequency
      Since:
        Ant 1.8.0