From 9681d769ed0984707e9367d1980813553256ce69 Mon Sep 17 00:00:00 2001
From: Marvin Killing <marvinkilling@gmail.com>
Date: Tue, 9 Nov 2010 12:27:41 +0100
Subject: [PATCH 1/3] implement _.combine function

---
 lib/underscore.lua | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/lib/underscore.lua b/lib/underscore.lua
index 7415190..e4bb939 100644
--- a/lib/underscore.lua
+++ b/lib/underscore.lua
@@ -97,6 +97,18 @@ function Underscore.funcs.map(list, func)
 	return mapped
 end
 
+function Underscore.funcs.combine(list, func)
+	local mapped = {}
+	local remaining_lists = _.map(_.rest(list), Underscore.iter)
+	for v1 in Underscore.iter(list[1]) do
+		local remaining_vals = _.map(remaining_lists, function (x)
+			return x()
+		end)
+		mapped[#mapped+1] = func(v1, unpack(remaining_vals))
+	end
+	return mapped
+end
+
 function Underscore.funcs.reduce(list, memo, func)	
 	for i in Underscore.iter(list) do
 		memo = func(memo, i)

From 2ae5918cf4e3dc54c6516c001cd947fc3a9c1c0c Mon Sep 17 00:00:00 2001
From: Marvin Killing <marvinkilling@gmail.com>
Date: Tue, 9 Nov 2010 14:26:09 +0100
Subject: [PATCH 2/3] add spec for _.combine

---
 spec/combine_spec.lua | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 spec/combine_spec.lua

diff --git a/spec/combine_spec.lua b/spec/combine_spec.lua
new file mode 100644
index 0000000..29b5ade
--- /dev/null
+++ b/spec/combine_spec.lua
@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe["_.combine"] = function()
+	before = function()
+		input = { {1,2,3}, {3,2,1,0}, {1,1,1,1,1} }
+		result = _.combine(input, function(a,b,c) return a+b+c end)
+	end
+	
+	it["should return an array of size of the first array with the elements of all arrays transformed by the function"] = function()
+		expect(result).should_equal {5,5,5}
+	end
+end
+
+
+spec:report(true)

From 2ffaac547779b14cdbc2a7572cd01d49efba2ef5 Mon Sep 17 00:00:00 2001
From: Marvin Killing <marvinkilling@gmail.com>
Date: Tue, 9 Nov 2010 14:32:36 +0100
Subject: [PATCH 3/3] update docs for _.combine

---
 docs/index.html         | 11 +++++++++++
 template/functions.yaml | 12 ++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/docs/index.html b/docs/index.html
index d6c022b..fbb8593 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -20,6 +20,9 @@ <h3>Iterator Functions</h3>
           <li>
             <a href='#map'>map</a>
           </li>
+          <li>
+            <a href='#combine'>combine</a>
+          </li>
           <li>
             <a href='#each'>each</a>
           </li>
@@ -222,6 +225,14 @@ <h3>Iterator Functions</h3>
           <p class='description'>Produces a new array by mapping each value in iter through a transformation function.</p>
           <pre class='example'>_.map({1,2,3}, function(i) return i*2 end)&#x000A;=> { 2,4,6 }</pre>
         </div>
+        <div class='function' id='combine'>
+          <p>
+            <strong class='name'>combine</strong>
+            <code>_.combine(iters, func)</code>
+          </p>
+          <p class='description'>Produces a new array by mapping each value in each array in iters through a transformation function.</p>
+          <pre class='example'>_.combine({ {1,2,3}, {3,2,1}, {1,1,1} }, function(a,b,c) a+b+c end)&#x000A;=> { 5,5,5 }&#x000A;_.combine({ {3,2,1}, {1,1,1,1,1} }, function(a,b) a+b end)&#x000A;=> { 4,3,2 }</pre>
+        </div>
         <div class='function' id='each'>
           <p>
             <strong class='name'>each</strong>
diff --git a/template/functions.yaml b/template/functions.yaml
index 0a504dc..38142c7 100644
--- a/template/functions.yaml
+++ b/template/functions.yaml
@@ -13,6 +13,18 @@ iterator_functions:
         _.map({1,2,3}, function(i) return i*2 end)
         => { 2,4,6 }
 
+    - name:
+        combine
+      params:
+        iters, func
+      description:
+        Produces a new array by mapping each value in each array in iters through a transformation function.
+      example: |
+        _.combine({ {1,2,3}, {3,2,1}, {1,1,1} }, function(a,b,c) a+b+c end)
+        => { 5,5,5 }
+        _.combine({ {3,2,1}, {1,1,1,1,1} }, function(a,b) a+b end)
+        => { 4,3,2 }
+
     - name: 
         each
       aliases: