Pull up into() from LazyIterable to RichIterable.

RELEASE_NOTE_DRAFT.md

@@ -7,6 +7,7 @@ New Functionality
 * Changed MutableBagIterable.addOccurrences(T item, int occurrences) to return the updated number of occurrences instead of void.
 * Implemented Multimap.keySet() to return an unmodifiable SetIterable of keys.
 * Implemented MutableMultimap.putAllPairs(Iterable<Pair<K, V>> keyValuePairs).
+* Pull up into() from LazyIterable to RichIterable
 
 Optimizations
 -------------

eclipse-collections-api/src/main/java/org/eclipse/collections/api/RichIterable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -1331,6 +1331,13 @@ <P> T detectWithIfNone(
      */
     double injectInto(double injectedValue, DoubleObjectToDoubleFunction<? super T> function);
 
+    /**
+     * Adds all the elements in this iterable to the specific target Collection.
+     *
+     * @since 8.0
+     */
+    <R extends Collection<T>> R into(R target);
+
     /**
      * Converts the collection to a MutableList implementation.
      *
@@ -1740,6 +1747,7 @@ <V, R extends MutableMap<V, T>> R groupByUniqueKey(
      * @return a string representation of this RichIterable
      * @since 1.0
      */
+    @Override
     String toString();
 
     /**

eclipse-collections-code-generator/src/main/resources/impl/map/immutable/immutablePrimitiveObjectEmptyMap.stg

@@ -413,6 +413,11 @@ final class Immutable<name>ObjectEmptyMap\<V> implements Immutable<name>ObjectMa
         return injectedValue;
     }
 
+    public \<R extends Collection\<V>\> R into(R target)
+    {
+        return target;
+    }
+
     public MutableList\<V> toList()
     {
         return Lists.mutable.with();

eclipse-collections-code-generator/src/main/resources/impl/map/immutable/immutablePrimitiveObjectHashMap.stg

@@ -388,6 +388,11 @@ final class Immutable<name>ObjectHashMap\<V> extends AbstractImmutable<name>Obje
         return this.delegate.injectInto(injectedValue, function);
     }
 
+    public \<R extends Collection\<V>\> R into(R target)
+    {
+        return this.delegate.into(target);
+    }
+
     public MutableList\<V> toList()
     {
         return this.delegate.toList();

eclipse-collections-code-generator/src/main/resources/impl/map/immutable/immutablePrimitiveObjectSingletonMap.stg

@@ -518,6 +518,11 @@ final class Immutable<name>ObjectSingletonMap\<V> extends AbstractImmutable<name
         return function.doubleValueOf(injectedValue, this.value1);
     }
 
+    public \<R extends Collection\<V>\> R into(R target)
+    {
+        return Iterate.addAllTo(this, target);
+    }
+
     public MutableList\<V> toList()
     {
         return Lists.mutable.with(this.value1);

eclipse-collections-code-generator/src/main/resources/impl/map/mutable/primitiveObjectHashMap.stg

@@ -1647,6 +1647,11 @@ public class <name>ObjectHashMap\<V> implements Mutable<name>ObjectMap\<V>, Exte
         return list;
     }
 
+    public \<R extends Collection\<V>\> R into(R target)
+    {
+        return Iterate.addAllTo(this, target);
+    }
+
     public MutableList\<V> toSortedList()
     {
         return this.toList().sortThis();

eclipse-collections-code-generator/src/main/resources/impl/map/mutable/synchronizedPrimitiveObjectMap.stg

@@ -732,6 +732,14 @@ public final class Synchronized<name>ObjectMap\<V>
         }
     }
 
+    public \<R extends Collection\<V>\> R into(R target)
+    {
+        synchronized (this.lock)
+        {
+            return this.map.into(target);
+        }
+    }
+
     public MutableList\<V> toList()
     {
         synchronized (this.lock)

eclipse-collections-code-generator/src/main/resources/impl/map/mutable/unmodifiablePrimitiveObjectMap.stg

@@ -507,6 +507,11 @@ public final class Unmodifiable<name>ObjectMap\<V>
         return this.map.injectInto(injectedValue, function);
     }
 
+    public \<R extends Collection\<V>\> R into(R target)
+    {
+        return this.map.into(target);
+    }
+
     public MutableList\<V> toList()
     {
         return this.map.toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/AbstractRichIterable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -475,6 +475,11 @@ public double injectInto(double injectedValue, DoubleObjectToDoubleFunction<? su
         return procedure.getResult();
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        return Iterate.addAllTo(this, target);
+    }
+
     public float injectInto(float injectedValue, FloatObjectToFloatFunction<? super T> function)
     {
         InjectIntoFloatProcedure<T> procedure = new InjectIntoFloatProcedure<T>(injectedValue, function);

eclipse-collections/src/main/java/org/eclipse/collections/impl/SynchronizedRichIterable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -603,6 +603,14 @@ public double injectInto(double injectedValue, DoubleObjectToDoubleFunction<? su
         }
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        synchronized (this.lock)
+        {
+            return this.iterable.into(target);
+        }
+    }
+
     public MutableList<T> toList()
     {
         synchronized (this.lock)

eclipse-collections/src/main/java/org/eclipse/collections/impl/UnmodifiableRichIterable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -506,6 +506,11 @@ public <V> ObjectDoubleMap<V> sumByDouble(Function<T, V> groupBy, DoubleFunction
         return this.iterable.sumByDouble(groupBy, function);
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        return this.iterable.into(target);
+    }
+
     public MutableList<T> toList()
     {
         return this.iterable.toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/bimap/AbstractBiMap.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -182,6 +182,11 @@ public RichIterable<Pair<K, V>> keyValuesView()
         return this.getDelegate().keyValuesView();
     }
 
+    public <R extends Collection<V>> R into(R target)
+    {
+        return this.getDelegate().into(target);
+    }
+
     public MutableList<V> toList()
     {
         return this.getDelegate().toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/collection/AbstractSynchronizedRichIterable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -502,6 +502,14 @@ public double injectInto(double injectedValue, DoubleObjectToDoubleFunction<? su
         }
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        synchronized (this.lock)
+        {
+            return this.delegate.into(target);
+        }
+    }
+
     public MutableList<T> toList()
     {
         synchronized (this.lock)

eclipse-collections/src/main/java/org/eclipse/collections/impl/collection/mutable/AbstractCollectionAdapter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -581,6 +581,11 @@ public <IV, P> IV injectIntoWith(
         return Iterate.injectIntoWith(injectValue, this.getDelegate(), function, parameter);
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        return Iterate.addAllTo(this.getDelegate(), target);
+    }
+
     public MutableList<T> toList()
     {
         return Lists.mutable.withAll(this.getDelegate());

eclipse-collections/src/main/java/org/eclipse/collections/impl/collection/mutable/AbstractMultiReaderMutableCollection.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -245,6 +245,19 @@ public <P> boolean anySatisfyWith(
         }
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        this.acquireReadLock();
+        try
+        {
+            return this.getDelegate().into(target);
+        }
+        finally
+        {
+            this.unlockReadLock();
+        }
+    }
+
     public MutableList<T> toList()
     {
         this.acquireReadLock();
@@ -1566,6 +1579,11 @@ public <P> boolean anySatisfyWith(
             return this.delegate.anySatisfyWith(predicate, parameter);
         }
 
+        public <R extends Collection<T>> R into(R target)
+        {
+            return this.delegate.into(target);
+        }
+
         public MutableList<T> toList()
         {
             return this.delegate.toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/collection/mutable/AbstractUnmodifiableMutableCollection.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -620,6 +620,11 @@ public <IV, P> IV injectIntoWith(
         return this.getMutableCollection().injectIntoWith(injectValue, function, parameter);
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        return this.getMutableCollection().into(target);
+    }
+
     public MutableList<T> toList()
     {
         return this.getMutableCollection().toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/map/mutable/UnmodifiableMutableMap.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -457,6 +457,11 @@ public LazyIterable<V> asLazy()
         return this.getMutableMap().asLazy();
     }
 
+    public <R extends Collection<V>> R into(R target)
+    {
+        return this.getMutableMap().into(target);
+    }
+
     public MutableList<V> toList()
     {
         return this.getMutableMap().toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/map/sorted/mutable/UnmodifiableTreeMap.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -472,6 +472,11 @@ public LazyIterable<V> asLazy()
         return this.getMutableSortedMap().asLazy();
     }
 
+    public <R extends Collection<V>> R into(R target)
+    {
+        return this.getMutableSortedMap().into(target);
+    }
+
     public MutableList<V> toList()
     {
         return this.getMutableSortedMap().toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/stack/immutable/ImmutableArrayStack.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -539,6 +539,11 @@ public float injectInto(float injectedValue, FloatObjectToFloatFunction<? super
         return this.delegate.asReversed().injectInto(injectedValue, floatObjectToFloatFunction);
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        return this.delegate.asReversed().into(target);
+    }
+
     public MutableList<T> toList()
     {
         return this.delegate.asReversed().toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/stack/mutable/ArrayStack.java

@@ -763,6 +763,11 @@ public void forEachWithIndex(ObjectIntProcedure<? super T> objectIntProcedure)
         this.delegate.asReversed().forEachWithIndex(objectIntProcedure);
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        return this.delegate.asReversed().into(target);
+    }
+
     public MutableList<T> toList()
     {
         return this.delegate.asReversed().toList();

eclipse-collections/src/main/java/org/eclipse/collections/impl/stack/mutable/SynchronizedStack.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -699,6 +699,14 @@ public double injectInto(double injectedValue, DoubleObjectToDoubleFunction<? su
         }
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        synchronized (this.lock)
+        {
+            return this.delegate.into(target);
+        }
+    }
+
     public MutableList<T> toList()
     {
         synchronized (this.lock)

eclipse-collections/src/main/java/org/eclipse/collections/impl/stack/mutable/UnmodifiableStack.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015 Goldman Sachs.
+ * Copyright (c) 2016 Goldman Sachs.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * and Eclipse Distribution License v. 1.0 which accompany this distribution.
@@ -447,6 +447,11 @@ public double injectInto(double injectedValue, DoubleObjectToDoubleFunction<? su
         return this.mutableStack.injectInto(injectedValue, doubleObjectToDoubleFunction);
     }
 
+    public <R extends Collection<T>> R into(R target)
+    {
+        return this.mutableStack.into(target);
+    }
+
     public MutableList<T> toList()
     {
         return this.mutableStack.toList();