Add "Functions/Splat Arguments" recipe.

Author: thirdtruck

chapters/functions/recursion.textile

@@ -31,3 +31,5 @@ setTimeout((->
 
 h2. Discussion
 
+While @arguments.callee@ allows for the recursion of anonymous functions and might have the advantage in a very memory-intensive application, named functions keep their purpose more explicit and make for more maintainable code.
+

chapters/functions/splat_arguments.textile

@@ -0,0 +1,50 @@
+---
+layout: recipe
+title: Splat Arguments
+chapter: Functions
+---
+
+h2. Problem
+
+Your function will be called with a varying number of arguments.
+
+h2. Solution
+
+Use _splats_.
+
+{% highlight coffeescript %}
+loadTruck = (firstDibs, secondDibs, tooSlow...) ->
+	truck: 
+		driversSeat: firstDibs
+		passengerSeat: secondDibs
+		trunkBed: tooSlow
+
+loadTruck("Amanda", "Joel")
+# => { truck: { driversSeat: "Amanda", passengerSeat: "Joel", trunkBed: [] } }
+
+loadTruck("Amanda", "Joel", "Bob", "Mary", "Phillip")
+# => { truck: { driversSeat: "Amanda", passengerSeat: "Joel", trunkBed: ["Bob", "Mary", "Phillip"] } }
+{% endhighlight %}
+
+With a trailing argument:
+
+{% highlight coffeescript %}
+loadTruck = (firstDibs, secondDibs, tooSlow..., leftAtHome) ->
+	truck:
+		driversSeat: firstDibs
+		passengerSeat: secondDibs
+		trunkBed: tooSlow
+	taxi:
+		passengerSeat: leftAtHome
+
+loadTruck("Amanda", "Joel", "Bob", "Mary", "Phillip", "Austin")
+# => { truck: { driversSeat: "Amanda", passengerSeat: "Joel", trunkBed: ["Bob", "Mary", "Phillip"] }, taxi: "Austin" }
+{% endhighlight %}
+
+loadTruck("Amanda")
+# => { truck: { driversSeat: "Amanda", passengerSeat: undefined, trunkBed: [] }, taxi: undefined }
+
+h2. Discussion
+
+By adding an ellipsis ("...") next to no more than one of a function's arguments, CoffeeScript will combine all of the argument values not captured by other named arguments into a list.  It will serve up an empty list even if some of the named arguments were not supplied.
+

wanted-recipes.textile

@@ -93,8 +93,6 @@ foo 1, 2, 3
 # => 6
 {% endhighlight %}
 
-* Variable arguments with splats
-
 h2. jQuery
 
 h2. Regular Expressions