New recipe: splitting a string.

Author: Dan Gilbert

chapters/strings/splitting-a-string.textile

@@ -0,0 +1,37 @@
+---
+layout: recipe
+title: Splitting a String
+chapter: Strings
+---
+
+h2. Problem
+
+You want to split a string.
+
+h2. Solution
+
+Use JavaScript's String split() method:
+
+{% highlight coffeescript %}
+"foo bar baz".split " "
+# => [ 'foo', 'bar', 'baz' ]
+{% endhighlight %}
+
+h2. Discussion
+
+String's split() is a standard JavaScript method. It can be used to split a string on any delimiter, including regular expressions. It also accepts a second parameter that specifies the number of splits to return.
+
+{% highlight coffeescript %}
+"foo-bar-baz".split "-"
+# => [ 'foo', 'bar', 'baz' ]
+{% endhighlight %}
+
+{% highlight coffeescript %}
+"foo   bar  \t baz".split /\s+/
+# => [ 'foo', 'bar', 'baz' ]
+{% endhighlight %}
+
+{% highlight coffeescript %}
+"the sun goes down and I sit on the old broken-down river pier".split " ", 2
+# => [ 'the', 'sun' ]
+{% endhighlight %}

wanted-recipes.textile

@@ -18,7 +18,6 @@ h2. Objects
 h2. Strings
 
 * HTML methods # JS .sup(), .sub(), .blink(), .link(url), etc. May not exist in your JS impl!
-* Splitting a string # JS "foo bar baz".split ' ' # => [ 'foo', 'bar', 'baz' ]
 * substr # str.substr(x,y)  === str[x..x+y-1] === str[x...x+y]
 * substring # str.substring(x,y) === str.slice(x,y)  === str[x..y-1] === str[x...y]
 * Uppercasing a string # JS toUpperCase()