From abccac2f06d0d8732d79843fda7c50814c8038a3 Mon Sep 17 00:00:00 2001
From: Flaviu Tamas <tamasflaviu@gmail.com>
Date: Fri, 16 Jan 2015 20:04:20 -0500
Subject: [PATCH] Add `split(...)`

---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 1f5f40cb76..1a4b49fdd3 100644
--- a/README.md
+++ b/README.md
@@ -104,3 +104,15 @@ Variants:
  - `findAllStr(...)` returns a `seq[string]`
 
 [iter-find]: #finditerstring-regex-start--0-endpos---1-regexmatch
+
+#### `split(string, Regex): seq[string]`
+
+Splits the string with the given regex. This works according to the rules that
+Perl and Javascript use.
+
+  - If the match is zero-width, then the string is still split:
+    `"123".split(r"") == @["1", "2", "3"]`.
+  - If the pattern has a capture in it, it is added after the string split:
+    `"12".split(re"(\d)") == @["", "1", "", "2", ""]`.
+
+[proc-split]: #splitstring-regex-seqstring