Add forEach and forEachRight for chain.

Author: javadev

src/main/java/com/github/underscore/$.java

@@ -1631,9 +1631,7 @@ public static <E> E[] clone(final E ... iterable) {
     }
 
     public static <T> void tap(final Iterable<T> iterable, final Block<? super T> func) {
-        for (T element : iterable) {
-            func.apply(element);
-        }
+        each(iterable, func);
     }
 
     public static <K, V> boolean isMatch(final Map<K, V> object, final Map<K, V> properties) {
@@ -1976,7 +1974,17 @@ public Chain<T> sample(final int howMany) {
         }
 
         public Chain<T> tap(final Block<T> func) {
-            $.tap(list, func);
+            $.each(list, func);
+            return new Chain<T>(list);
+        }
+
+        public Chain<T> forEach(final Block<T> func) {
+            $.each(list, func);
+            return new Chain<T>(list);
+        }
+
+        public Chain<T> forEachRight(final Block<T> func) {
+            $.eachRight(list, func);
             return new Chain<T>(list);
         }
 

src/test/java/com/github/underscore/CollectionsTest.java

@@ -96,6 +96,14 @@ public void apply(Integer item) {
             }
         });
         assertEquals("[1, 2, 3]", result.toString());
+        final List<Map.Entry<String, Integer>> resultChain = new ArrayList<Map.Entry<String, Integer>>();
+        $.chain((new LinkedHashMap<String, Integer>() { { put("a", 1); put("b", 2); put("c", 3); } }).entrySet())
+            .forEach(new Block<Map.Entry<String, Integer>>() {
+                public void apply(final Map.Entry<String, Integer> item) {
+                    resultChain.add(item);
+                }
+            });
+        assertEquals("[a=1, b=2, c=3]", resultChain.toString());
     }
 
 /*
@@ -119,6 +127,14 @@ public void apply(Integer item) {
             }
         });
         assertEquals("[3, 2, 1]", result2.toString());
+        final List<Map.Entry<String, Integer>> resultChain = new ArrayList<Map.Entry<String, Integer>>();
+        $.chain((new LinkedHashMap<String, Integer>() { { put("a", 1); put("b", 2); put("c", 3); } }).entrySet())
+            .forEachRight(new Block<Map.Entry<String, Integer>>() {
+                public void apply(final Map.Entry<String, Integer> item) {
+                    resultChain.add(item);
+                }
+            });
+        assertEquals("[c=3, b=2, a=1]", resultChain.toString());
     }
 
 /*