aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--string.c12
1 files changed, 8 insertions, 4 deletions
diff --git a/string.c b/string.c
index df3f8fd3cd..cd633e1226 100644
--- a/string.c
+++ b/string.c
@@ -7285,7 +7285,7 @@ static const char isspacetable[256] = {
/*
* call-seq:
- * str.split(pattern=nil, [limit]) -> anArray
+ * str.split(pattern=nil, [limit]) -> an_array
*
* Divides <i>str</i> into substrings based on a delimiter, returning an array
* of these substrings.
@@ -7305,9 +7305,11 @@ static const char isspacetable[256] = {
* split on whitespace as if ' ' were specified.
*
* If the <i>limit</i> parameter is omitted, trailing null fields are
- * suppressed. If <i>limit</i> is a positive number, at most that number of
- * fields will be returned (if <i>limit</i> is <code>1</code>, the entire
- * string is returned as the only entry in an array). If negative, there is no
+ * suppressed. If <i>limit</i> is a positive number, at most that number
+ * of split substrings will be returned (captured groups will be returned
+ * as well, but are not counted towards the limit).
+ * If <i>limit</i> is <code>1</code>, the entire
+ * string is returned as the only entry in an array. If negative, there is no
* limit to the number of fields returned, and trailing null fields are not
* suppressed.
*
@@ -7327,6 +7329,8 @@ static const char isspacetable[256] = {
* "1,2,,3,4,,".split(',', 4) #=> ["1", "2", "", "3,4,,"]
* "1,2,,3,4,,".split(',', -4) #=> ["1", "2", "", "3", "4", "", ""]
*
+ * "1:2:3".split(/(:)()()/, 2) #=> ["1", ":", "", "", "2:3"]
+ *
* "".split(',', -1) #=> []
*/