Merge pull request #2920 from kyanagi/update_string_split_awk_mode_trailing_spaces

`String#split`に`' '`を指定した場合の説明を修正

Author: znz

refm/api/src/_builtin/String

@@ -2286,9 +2286,9 @@ string                  #=> "thing"
 : 文字列
     その文字列自体にマッチする部分で分割する。
 : 1 バイトの空白文字 ' '
-    先頭と末尾の空白を除いたうえで、空白文字列で分割する。
+    先頭の連続する空白を除いたうえで、連続する空白で分割する。
 : nil
-    常に $; で分割する。 $; も nil の場合は、先頭と末尾の空白を除いたうえで、空白文字列で分割する。
+    常に $; で分割する。 $; も nil の場合は、1 バイトの空白文字を指定したのと同じ動作となる。
 : 空文字列 '' あるいは空文字列にマッチする正規表現
     文字列を 1 文字ずつに分割する。マルチバイト文字を認識する。
 
@@ -2354,6 +2354,18 @@ p "a,b,c,d,e".split(/,/, 7)  # => ["a", "b", "c", "d", "e"]
 p "a,b,c,,,".split(/,/, -1)    # => ["a", "b", "c", "", "", ""]
 #@end
 
+#@samplecode 1 バイトの空白文字を指定した場合の挙動
+# まず "   a   b   " から先頭の連続する空白を除き "a   b   " が分割対象となる。
+# これを連続する空白で分割し、["a", "b", ""] となる。
+p "   a   b   ".split(' ', -1) # => ["a", "b", ""]
+
+# limit == -1 の場合と比べると、結果の配列末尾に含まれる空文字列が取り除かれている。
+p "   a   b   ".split(' ', 0)  # => ["a", "b"]
+
+# limit == 1 の場合は元の文字列がそのまま含まれる。
+p "   a   b   ".split(' ', 1)  # => ["   a   b   "]
+#@end
+
 @see [[m:String#partition]], [[m:String#rpartition]]
 
 --- squeeze(*chars) -> String