update string.split

2 files changed, 57 insertions, 15 deletions

diff --git a/manual.md b/manual.md
index b92ddf05..0842c274 100644
--- a/manual.md
+++ b/manual.md
@@ -6461,23 +6461,42 @@ end
 
 ###### string.split
 
-- Split string
+pattern match and ignore empty string
 
-The string is separated by the specified separator. The separator can be: character, string, pattern matching string, for example:
+```lua
+("1\n\n2\n3"):split('\n') => 1, 2, 3
+("abc123123xyz123abc"):split('123') => abc, xyz, abc
+("abc123123xyz123abc"):split('[123]+') => abc, xyz, abc
+```
+
+plain match and ignore empty string
+
+```lua
+("1\n\n2\n3"):split('\n', {plain = true}) => 1, 2, 3
+("abc123123xyz123abc"):split('123', {plain = true}) => abc, xyz, abc
+```
+
+pattern match and contains empty string
 
 ```lua
-local s = "hello xmake!"
-s:split("%s+")
+("1\n\n2\n3"):split('\n', {strict = true}) => 1, , 2, 3
+("abc123123xyz123abc"):split('123', {strict = true}) => abc, , xyz, abc
+("abc123123xyz123abc"):split('[123]+', {strict = true}) => abc, xyz, abc
 ```
 
-Split according to consecutive whitespace characters, the result is: `hello`, `xmake!`
+plain match and contains empty string
 
 ```lua
-local s = "hello,xmake:123"
-s:split("[,:]")
+("1\n\n2\n3"):split('\n', {plain = true, strict = true}) => 1, , 2, 3
+("abc123123xyz123abc"):split('123', {plain = true, strict = true}) => abc, , xyz, abc
 ```
 
-The above code is split according to the `, ` or `:` characters. The result is: `hello`, `xmake`, `123`
+limit split count
+
+```lua
+("1\n\n2\n3"):split('\n', {limit = 2}) => 1, 2\n3
+("1.2.3.4.5"):split('%.', {limit = 3}) => 1, 2, 3.4.5
+```
 
 ###### string.trim
 
diff --git a/zh/manual.md b/zh/manual.md
index 4fc58bcf..bee6d49a 100644
--- a/zh/manual.md
+++ b/zh/manual.md
@@ -6540,21 +6540,44 @@ end
 
 - 分割字符串
 
-通过指定的分隔符进行字符串分割，分隔符可以是：字符，字符串、模式匹配字符串，例如：
+v2.2.7版本对这个接口做了改进，以下是对2.2.7之后版本的使用说明。
+
+按模式匹配分割字符串，忽略空串，例如：
+
+```lua
+("1\n\n2\n3"):split('\n') => 1, 2, 3
+("abc123123xyz123abc"):split('123') => abc, xyz, abc
+("abc123123xyz123abc"):split('[123]+') => abc, xyz, abc
+```
+
+按纯文本匹配分割字符串，忽略空串（省去了模式匹配，会提升稍许性能），例如：
+
+```lua
+("1\n\n2\n3"):split('\n', {plain = true}) => 1, 2, 3
+("abc123123xyz123abc"):split('123', {plain = true}) => abc, xyz, abc
+```
+
+按模式匹配分割字符串，严格匹配，不忽略空串，例如：
 
 ```lua
-local s = "hello     xmake!"
-s:split("%s+")
+("1\n\n2\n3"):split('\n', {strict = true}) => 1, , 2, 3
+("abc123123xyz123abc"):split('123', {strict = true}) => abc, , xyz, abc
+("abc123123xyz123abc"):split('[123]+', {strict = true}) => abc, xyz, abc
 ```
 
-根据连续空白字符进行分割，结果为：`hello`, `xmake!`
+按纯文本匹配分割字符串，严格匹配，不忽略空串（省去了模式匹配，会提升稍许性能），例如：
 
 ```lua
-local s = "hello,xmake:123"
-s:split("[,:]")
+("1\n\n2\n3"):split('\n', {plain = true, strict = true}) => 1, , 2, 3
+("abc123123xyz123abc"):split('123', {plain = true, strict = true}) => abc, , xyz, abc
 ```
 
-上面的代码根据`,`或者`:`字符进行分割，结果为：`hello`, `xmake`, `123`
+限制分割块数
+
+```lua
+("1\n\n2\n3"):split('\n', {limit = 2}) => 1, 2\n3
+("1.2.3.4.5"):split('%.', {limit = 3}) => 1, 2, 3.4.5
+```
 
 ###### string.trim