doc: update doc for Break function

Slice: break (#200 )
Splits a slice into two based on a predicate function. It starts appending to the second slice after the first element that matches the predicate. All elements after the first match are included in the second slice, regardless of whether they match the predicate or not.
2026-02-16 10:42:27 +08:00 · 2024-03-08 21:39:06 +08:00 · 2024-03-07 14:11:19 +08:00 · 2024-03-06 16:19:20 +08:00 · 2024-03-06 15:28:55 +08:00 · 2024-03-06 14:52:35 +08:00
25 changed files with 464 additions and 185 deletions
--- a/README.md
+++ b/README.md
@@ -660,9 +660,12 @@ import "github.com/duke-git/lancet/v2/fileutil"
 -   **<big>CreateDir</big>** : create directory in absolute path.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#CreateDir)]
    [[play](https://go.dev/play/p/qUuCe1OGQnM)]
-   **<big>CopyFile</big>** :copy src file to dest file.
+-   **<big>CopyFile</big>** : copy src file to dest file.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#CopyFile)]
    [[play](https://go.dev/play/p/Jg9AMJMLrJi)]
+-   **<big>CopyDir</big>** : copy src directory to dest directory.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#CopyDir)]
+    [[play](https://go.dev/play/p/YAyFTA_UuPb)]
 -   **<big>FileMode</big>** : return file's mode and permission.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#FileMode)]
    [[play](https://go.dev/play/p/2l2hI42fA3p)]
@@ -731,8 +734,10 @@ import "github.com/duke-git/lancet/v2/fileutil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#ReadFile)]
 -   **<big>ChunkRead</big>** : reads a block from the file at the specified offset and returns all lines within the block.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#ChunkRead)]
+    [[play](https://go.dev/play/p/r0hPmKWhsgf)]
 -   **<big>ParallelChunkRead</big>** : reads the file in parallel and send each chunk of lines to the specified channel.
-    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#ParallelChunkRead)]    
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/fileutil.md#ParallelChunkRead)]  
+    [[play](https://go.dev/play/p/teMXnCsdSEw)]

 <h3 id="formatter"> 10. Formatter contains some functions for data formatting. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>

@@ -795,20 +800,28 @@ import "github.com/duke-git/lancet/v2/function"
    [[play](https://go.dev/play/p/hbON-Xeyn5N)]
 -   **<big>Pipeline</big>** : takes a list of functions and returns a function whose param will be passed into the functions one by one.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#Pipeline)]
+    [[play](https://go.dev/play/p/mPdUVvj6HD6)]
 -   **<big>AcceptIf</big>** : returns another function of the same signature as the apply function but also includes a bool value to indicate success or failure.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#AcceptIf)]
+    [[play](https://go.dev/play/p/XlXHHtzCf7d)]
 -   **<big>And</big>** : returns a composed predicate that represents the logical AND of a list of predicates.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#And)]
+    [[play](https://go.dev/play/p/dTBHJMQ0zD2)]
 -   **<big>Or</big>** : returns a composed predicate that represents the logical OR of a list of predicates.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#Or)]
+    [[play](https://go.dev/play/p/LitCIsDFNDA)]
 -   **<big>Negate</big>** : returns a predicate that represents the logical negation of this predicate.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#Negate)]
+    [[play](https://go.dev/play/p/jbI8BtgFnVE)]
 -   **<big>Nor</big>** : returns a composed predicate that represents the logical NOR of a list of predicates.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#Nor)]
+    [[play](https://go.dev/play/p/2KdCoBEOq84)]
 -   **<big>Nand</big>** : returns a composed predicate that represents the logical Nand of a list of predicates.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#Nand)]
+    [[play](https://go.dev/play/p/Rb-FdNGpgSO)]
 -   **<big>Xnor</big>** : returns a composed predicate that represents the logical XNOR of a list of predicates.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#Xnor)]
+    [[play](https://go.dev/play/p/FJxko8SFbqc)]
 -   **<big>Watcher</big>** : Watcher is used for record code execution time. can start/stop/reset the watch timer. get the elapsed time of function execution.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/function.md#Watcher)]
    [[play](https://go.dev/play/p/l2yrOpCLd1I)]
@@ -959,12 +972,16 @@ import "github.com/duke-git/lancet/v2/mathutil"
    [[play](https://go.dev/play/p/aumarSHIGzP)]
 -   **<big>CeilToFloat</big>** : round float up n decimal places.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#CeilToFloat)]
+    [[play](https://go.dev/play/p/8hOeSADZPCo)]
 -   **<big>CeilToString</big>** : round float up n decimal places, then conver to string.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#CeilToString)]
+    [[play](https://go.dev/play/p/wy5bYEyUKKG)]
 -   **<big>FloorToFloat</big>** : round float down n decimal places.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#FloorToFloat)]
+    [[play](https://go.dev/play/p/vbCBrQHZEED)]
 -   **<big>FloorToString</big>** : round float down n decimal places, then conver to string.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#FloorToString)]
+    [[play](https://go.dev/play/p/Qk9KPd2IdDb)]
 -   **<big>Range</big>** : Creates a slice of numbers from start with specified count, element step is 1.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#Range)]
    [[play](https://go.dev/play/p/9ke2opxa8ZP)]
@@ -1006,6 +1023,7 @@ import "github.com/duke-git/lancet/v2/mathutil"
    [[play](https://go.dev/play/p/fsyBh1Os-1d)]
 -   **<big>Div</big>** : returns the result of x divided by y.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#Div)]
+    [[play](https://go.dev/play/p/WLxDdGXXYat)]


 <h3 id="netutil"> 14. Netutil package contains functions to get net information and send http request. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>
@@ -1413,6 +1431,8 @@ import "github.com/duke-git/lancet/v2/slice"
    [[play](https://go.dev/play/p/UzpGQptWppw)]
 -   **<big>SetToDefaultIf</big>** : set elements to their default value if they match the given predicate.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/slice.md#SetToDefaultIf)]
+    [[play](https://go.dev/play/p/9AXGlPRC0-A)]
+


 <h3 id="stream"> 19. Stream package implements a sequence of elements supporting sequential and operations. this package is an experiment to explore if stream in go can work as the way java does. its function is very limited. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>
@@ -1660,8 +1680,11 @@ import "github.com/duke-git/lancet/v2/strutil"
    [[play](https://go.dev/play/p/HzLC9vsTwkf)]
 -   **<big>SubInBetween</big>** : return substring between the start and end position(excluded) of source string.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/strutil.md#SubInBetween)]
+    [[play](https://go.dev/play/p/EDbaRvjeNsv)]
 -   **<big>HammingDistance</big>** : calculates the Hamming distance between two strings.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/strutil.md#HammingDistance)]
+    [[play](https://go.dev/play/p/glNdQEA9HUi)]
+

 <h3 id="system"> 22. System package contain some functions about os, runtime, shell command. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>

--- a/README_zh-CN.md
+++ b/README_zh-CN.md
@@ -659,9 +659,12 @@ import "github.com/duke-git/lancet/v2/fileutil"
 -   **<big>CreateDir</big>** : 创建嵌套目录，例如/a/, /a/b/。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/fileutil.md#CreateDir)]
    [[play](https://go.dev/play/p/qUuCe1OGQnM)]
-   **<big>CopyFile</big>** :拷贝文件，会覆盖原有的文件。
+-   **<big>CopyFile</big>** : 拷贝文件，会覆盖原有的文件。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/fileutil.md#CopyFile)]
    [[play](https://go.dev/play/p/Jg9AMJMLrJi)]
+-   **<big>CopyDir</big>** : 拷贝目录。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/fileutil.md#CopyDir)]
+    [[play](https://go.dev/play/p/YAyFTA_UuPb)]
 -   **<big>FileMode</big>** : 获取文件 mode 信息。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/fileutil.md#FileMode)]
    [[play](https://go.dev/play/p/2l2hI42fA3p)]
@@ -730,8 +733,10 @@ import "github.com/duke-git/lancet/v2/fileutil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/fileutil.md#ReadFile)]
 -   **<big>ChunkRead</big>** : 从文件的指定偏移读取块并返回块内所有行。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/fileutil.md#ChunkRead)]
+    [[play](https://go.dev/play/p/r0hPmKWhsgf)]
 -   **<big>ParallelChunkRead</big>** : 并行读取文件并将每个块的行发送到指定通道。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/fileutil.md#ParallelChunkRead)]
+    [[play](https://go.dev/play/p/teMXnCsdSEw)]



@@ -799,22 +804,31 @@ import "github.com/duke-git/lancet/v2/function"
    [[play](https://go.dev/play/p/mPdUVvj6HD6)]
 -   **<big>AcceptIf</big>** : AcceptIf函数会返回另一个函数，该函数的签名与apply函数相同，但同时还会包含一个布尔值来表示成功或失败。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#AcceptIf)]
+    [[play](https://go.dev/play/p/XlXHHtzCf7d)]
 -   **<big>And</big>** : 返回一个复合谓词判断函数，该判断函数表示一组谓词的逻辑and操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#And)]
+    [[play](https://go.dev/play/p/dTBHJMQ0zD2)]
 -   **<big>Or</big>** : 返回一个复合谓词判断函数，该判断函数表示一组谓词的逻辑or操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Or)]
+    [[play](https://go.dev/play/p/LitCIsDFNDA)]
 -   **<big>Negate</big>** : 返回一个谓词函数，该谓词函数表示当前谓词的逻辑否定。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Negate)]
+    [[play](https://go.dev/play/p/jbI8BtgFnVE)]
 -   **<big>Nor</big>** : 返回一个复合谓词判断函数，该判断函数表示一组谓词的逻辑非或nor的操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Nor)]
+    [[play](https://go.dev/play/p/2KdCoBEOq84)]
 -   **<big>Nand</big>** : 返回一个复合谓词判断函数，该判断函数表示一组谓词的逻辑非与nand的操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Nand)]
+    [[play](https://go.dev/play/p/Rb-FdNGpgSO)]
 -   **<big>Xnor</big>** : 返回一个复合谓词判断函数，该判断函数表示一组谓词的逻辑异或xnor的操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Xnor)]
+    [[play](https://go.dev/play/p/FJxko8SFbqc)]
 -   **<big>Watcher</big>** : Watcher 用于记录代码执行时间。可以启动/停止/重置手表定时器。获取函数执行的时间。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Watcher)]
    [[play](https://go.dev/play/p/l2yrOpCLd1I)]

+
+
 <h3 id="maputil"> 12. maputil 包括一些操作 map 的函数。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

 ```go
@@ -960,12 +974,16 @@ import "github.com/duke-git/lancet/v2/mathutil"
    [[play](https://go.dev/play/p/aumarSHIGzP)]
 -   **<big>CeilToFloat</big>** : 向上舍入（进一法），保留n位小数。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#CeilToFloat)]
+    [[play](https://go.dev/play/p/8hOeSADZPCo)]
 -   **<big>CeilToString</big>** : 向上舍入（进一法），保留n位小数，返回字符串。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#CeilToString)]
+    [[play](https://go.dev/play/p/wy5bYEyUKKG)]
 -   **<big>FloorToFloat</big>** : 向下舍入（去尾法），保留n位小数。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#FloorToFloat)]
+    [[play](https://go.dev/play/p/vbCBrQHZEED)]
 -   **<big>FloorToString</big>** : 向下舍入（去尾法），保留n位小数，返回字符串。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#FloorToString)]
+    [[play](https://go.dev/play/p/Qk9KPd2IdDb)]
 -   **<big>Range</big>** : 根据指定的起始值和数量，创建一个数字切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#Range)]
    [[play](https://go.dev/play/p/9ke2opxa8ZP)]
@@ -1007,7 +1025,7 @@ import "github.com/duke-git/lancet/v2/mathutil"
    [[play](https://go.dev/play/p/fsyBh1Os-1d)]
 -   **<big>Div</big>** : 除法运算。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#Div)]
-
+    [[play](https://go.dev/play/p/WLxDdGXXYat)]


 <h3 id="netutil"> 14. netutil 网络包支持获取 ip 地址，发送 http 请求。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>
@@ -1412,6 +1430,7 @@ import "github.com/duke-git/lancet/v2/slice"
    [[play](https://go.dev/play/p/UzpGQptWppw)]
 -   **<big>SetToDefaultIf</big>** : 根据给定给定的predicate判定函数来修改切片中的元素。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#SetToDefaultIf)]
+    [[play](https://go.dev/play/p/9AXGlPRC0-A)]



@@ -1663,8 +1682,11 @@ import "github.com/duke-git/lancet/v2/strutil"
    [[play](https://go.dev/play/p/HzLC9vsTwkf)]
 -   **<big>SubInBetween</big>** : 获取字符串中指定的起始字符串start和终止字符串end直接的子字符串。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#SubInBetween)]
+    [[play](https://go.dev/play/p/EDbaRvjeNsv)]
 -   **<big>HammingDistance</big>** : 计算两个字符串之间的汉明距离。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#HammingDistance)]
+    [[play](https://go.dev/play/p/glNdQEA9HUi)]
+

 <h3 id="system"> 22. system 包含 os, runtime, shell command 的相关函数。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

--- a/convertor/convertor.go
+++ b/convertor/convertor.go
@@ -397,6 +397,7 @@ func GbkToUtf8(bs []byte) ([]byte, error) {
 }

 // ToStdBase64 convert data to standard base64 encoding.
+// Play: https://go.dev/play/p/_fLJqJD3NMo
 func ToStdBase64(value any) string {
 	if value == nil || (reflect.ValueOf(value).Kind() == reflect.Ptr && reflect.ValueOf(value).IsNil()) {
 		return ""
@@ -418,6 +419,7 @@ func ToStdBase64(value any) string {
 }

 // ToUrlBase64 convert data to URL base64 encoding.
+// Play: https://go.dev/play/p/C_d0GlvEeUR
 func ToUrlBase64(value any) string {
 	if value == nil || (reflect.ValueOf(value).Kind() == reflect.Ptr && reflect.ValueOf(value).IsNil()) {
 		return ""
@@ -439,6 +441,7 @@ func ToUrlBase64(value any) string {
 }

 // ToRawStdBase64 convert data to raw standard base64 encoding.
+// Play: https://go.dev/play/p/wSAr3sfkDcv
 func ToRawStdBase64(value any) string {
 	if value == nil || (reflect.ValueOf(value).Kind() == reflect.Ptr && reflect.ValueOf(value).IsNil()) {
 		return ""
@@ -460,6 +463,7 @@ func ToRawStdBase64(value any) string {
 }

 // ToRawUrlBase64 convert data to raw URL base64 encoding.
+// Play: https://go.dev/play/p/HwdDPFcza1O
 func ToRawUrlBase64(value any) string {
 	if value == nil || (reflect.ValueOf(value).Kind() == reflect.Ptr && reflect.ValueOf(value).IsNil()) {
 		return ""
--- a/docs/api/packages/convertor.md
+++ b/docs/api/packages/convertor.md
@@ -891,7 +891,7 @@ func main() {
 func ToStdBase64(value any) string
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/_fLJqJD3NMo)</span></b>

 ```go
 package main
@@ -963,7 +963,7 @@ func main() {
 func ToUrlBase64(value any) string
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/C_d0GlvEeUR)</span></b>

 ```go
 package main
@@ -1032,7 +1032,7 @@ func main() {
 func ToRawStdBase64(value any) string
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/wSAr3sfkDcv)</span></b>

 ```go
 package main
@@ -1064,7 +1064,7 @@ func main() {
    fmt.Println(afterEncode)

    floatVal := 123.456
-    afterEncode = convertor.ToRawStdBase64(floatVal)
+    afterEncode := convertor.ToRawStdBase64(floatVal)
    fmt.Println(afterEncode)

    boolVal := true
@@ -1090,7 +1090,7 @@ func main() {

 <p>值转换为 ToRawUrlBase64 编码的字符串。error 类型的数据也会把 error 的原因进行编码，复杂的结构会转为 JSON 格式的字符串</p>

-<b>函数签名:</b>
+<b>函数签名:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/HwdDPFcza1O)</span></b>

 ```go
 func ToRawUrlBase64(value any) string
@@ -1109,7 +1109,7 @@ import (
 func main() {

    stringVal := "hello"
-    afterEncode = convertor.ToRawUrlBase64(stringVal)
+    afterEncode := convertor.ToRawUrlBase64(stringVal)
    fmt.Println(afterEncode)

    byteSliceVal := []byte("hello")
@@ -1132,11 +1132,11 @@ func main() {
    fmt.Println(afterEncode)

    boolVal := true
-    afterEncode = convertor.ToRawStdBase64(boolVal)
+    afterEncode = convertor.ToRawUrlBase64(boolVal)
    fmt.Println(afterEncode)

    errVal := errors.New("err")
-    afterEncode = convertor.ToRawStdBase64(errVal)
+    afterEncode = convertor.ToRawUrlBase64(errVal)
    fmt.Println(afterEncode)

    // Output:
--- a/docs/api/packages/datastructure/hashmap.md
+++ b/docs/api/packages/datastructure/hashmap.md
@@ -31,6 +31,7 @@ import (
 - [Iterate](#Iterate)
 - [Keys](#Keys)
 - [Values](#Values)
+- [FilterByValue](#FilterByValue)

 <div STYLE="page-break-after: always;"></div>

@@ -276,7 +277,7 @@ func main() {

 ### <span id="Values">Values</span>

-<p>返回hashmap所有值的切片 (随机顺序).</p>
+<p>返回hashmap所有值的切片 (随机顺序)。</p>

 <b>函数签名:</b>

@@ -306,3 +307,40 @@ func main() {
 ```


+### <span id="FilterByValue">FilterByValue</span>
+
+<p>返回一个过滤后的HashMap。 如果任何值与 perdicate 函数不匹配，则返回 nil，否则返回包含选定值的 HashMap。</p>
+
+<b>函数签名:</b>
+
+```go
+func (hm *HashMap) FilterByValue(perdicate func(value any) bool) *HashMap
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    hashmap "github.com/duke-git/lancet/v2/datastructure/hashmap"
+)
+
+func main() {
+    hm := hashmap.NewHashMap()
+
+    hm.Put("a", 1)
+    hm.Put("b", 2)
+    hm.Put("c", 3)
+    hm.Put("d", 4)
+    hm.Put("e", 5)
+    hm.Put("f", 6)
+
+    filteredHM := hm.FilterByValue(func(value any) bool {
+        return value.(int) == 1 || value.(int) == 3
+    })
+
+    fmt.Println(filteredHM.Size()) //2
+}
+```
--- a/docs/api/packages/fileutil.md
+++ b/docs/api/packages/fileutil.md
@@ -976,7 +976,7 @@ func main() {
 func ChunkRead(file *os.File, offset int64, size int, bufPool *sync.Pool) ([]string, error)
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/r0hPmKWhsgf)</span></b>

 ```go
 package main
@@ -1035,7 +1035,7 @@ func main() {
 func ParallelChunkRead(filePath string, linesCh chan<- []string, chunkSizeMB, maxGoroutine int) error
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/teMXnCsdSEw)</span></b>

 ```go
 package main
--- a/docs/api/packages/function.md
+++ b/docs/api/packages/function.md
@@ -424,7 +424,7 @@ func longRunningTask() {
 func And[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/dTBHJMQ0zD2)</span></b>

 ```go
 package main
@@ -461,7 +461,7 @@ func main() {
 func Or[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/LitCIsDFNDA)</span></b>

 ```go
 package main
@@ -496,7 +496,7 @@ func main() {
 func Negate[T any](predicate func(T) bool) func(T) bool
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/jbI8BtgFnVE)</span></b>

 ```go
 package main
@@ -536,7 +536,7 @@ func main() {
 func Nor[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/2KdCoBEOq84)</span></b>

 ```go
 package main
@@ -578,7 +578,7 @@ func main() {
 func Nand[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/Rb-FdNGpgSO)</span></b>

 ```go
 package main
@@ -615,7 +615,7 @@ func main() {
 func Xnor[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/FJxko8SFbqc)</span></b>

 ```go
 package main
@@ -652,7 +652,7 @@ func main() {
 func AcceptIf[T any](predicate func(T) bool, apply func(T) T) func(T) (T, bool)
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/XlXHHtzCf7d)</span></b>

 ```go
 package main
@@ -663,9 +663,8 @@ import (
 )

 func main() {
-
-    adder := AcceptIf(
-        And(
+    adder := function.AcceptIf(
+        function.And(
            func(x int) bool {
                return x > 10
            }, func(x int) bool {
--- a/docs/api/packages/mathutil.md
+++ b/docs/api/packages/mathutil.md
@@ -508,7 +508,7 @@ func main() {
 func CeilToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/8hOeSADZPCo)</span></b>

 ```go
 package main
@@ -544,7 +544,7 @@ func main() {
 func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/wy5bYEyUKKG)</span></b>

 ```go
 package main
@@ -577,10 +577,10 @@ func main() {
 <b>函数签名:</b>

 ```go
-func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+func FloorToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/vbCBrQHZEED)</span></b>

 ```go
 package main
@@ -613,10 +613,10 @@ func main() {
 <b>函数签名:</b>

 ```go
-func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+func FloorToString[T constraints.Float | constraints.Integer](x T, n int) string
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/Qk9KPd2IdDb)</span></b>

 ```go
 package main
@@ -1130,7 +1130,7 @@ func main() {

 ### <span id="Div">Div</span>

-<p>除法运算.</p>
+<p>除法运算。</p>

 <b>函数签名:</b>

@@ -1138,7 +1138,7 @@ func main() {
 func Div[T constraints.Float | constraints.Integer](x T, y T) float64
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/WLxDdGXXYat)</span></b>

 ```go
 package main
@@ -1156,6 +1156,7 @@ func main() {
    fmt.Println(result1)
    fmt.Println(result2)
    fmt.Println(result3)
+
    // Output:
    // 2.25
    // 0.5
--- a/docs/api/packages/slice.md
+++ b/docs/api/packages/slice.md
@@ -94,6 +94,7 @@ import (
 -   [Join](#Join)
 -   [Partition](#Partition)
 -   [SetToDefaultIf](#SetToDefaultIf)
+-   [Break](#Break)

 <div STYLE="page-break-after: always;"></div>

@@ -2581,7 +2582,7 @@ func main() {
 func SetToDefaultIf[T any](slice []T, predicate func(T) bool) ([]T, int)
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/9AXGlPRC0-A)</span></b>

 ```go
 import (
@@ -2600,4 +2601,37 @@ func main() {
 	// [ b  c d ]
 	// 3
 }
+```
+
+### <span id="Break">Break</span>
+
+<p>根据判断函数将切片分成两部分。它开始附加到与函数匹配的第一个元素之后的第二个切片。第一个匹配之后的所有元素都包含在第二个切片中，无论它们是否与函数匹配。</p>
+
+<b>示例:</b>
+
+```go
+func Break[T any](values []T, predicate func(T) bool) ([]T, []T)
+```
+
+<b>Example:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/slice"
+)
+
+func main() {
+    nums := []int{1, 2, 3, 4, 5}
+    even := func(n int) bool { return n%2 == 0 }
+
+    resultEven, resultAfterFirstEven := slice.Break(nums, even)
+    
+    fmt.Println(resultEven)
+    fmt.Println(resultAfterFirstEven)
+    
+    // Output:
+    // [1]
+    // [2 3 4 5]
+}
 ```
--- a/docs/api/packages/strutil.md
+++ b/docs/api/packages/strutil.md
@@ -1475,7 +1475,7 @@ func main() {
 func SubInBetween(str string, start string, end string) string
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/EDbaRvjeNsv)</span></b>

 ```go
 import (
@@ -1505,10 +1505,10 @@ func main() {
 <b>函数签名:</b>

 ```go
-HammingDistance(a, b string) (int, error)
+func HammingDistance(a, b string) (int, error)
 ```

-<b>示例:</b>
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/glNdQEA9HUi)</span></b>

 ```go
 import (
--- a/docs/en/api/packages/convertor.md
+++ b/docs/en/api/packages/convertor.md
@@ -571,6 +571,7 @@ func main() {
 }
 ```

+
 ### <span id="EncodeByte">EncodeByte</span>

 <p>Encode data to byte slice.</p>
@@ -610,7 +611,7 @@ func main() {
 func DecodeByte(data []byte, target any) error
 ```

-<b>Example:<span style="float:right;display:inline-block;"></b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/zI6xsmuQRbn)</span></b>

 ```go
 package main
@@ -636,69 +637,6 @@ func main() {
 }
 ```

-### <span id="DeepClone">DeepClone</span>
-
-<p>Creates a deep copy of passed item, can't clone unexported field of struct.</p>
-
-<b>Signature:</b>
-
-```go
-func DeepClone[T any](src T) T
-```
-
-<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/j4DP5dquxnk)</span></b>
-
-```go
-package main
-
-import (
-    "fmt"
-    "github.com/duke-git/lancet/v2/convertor"
-)
-
-func main() {
-    type Struct struct {
-        Str        string
-        Int        int
-        Float      float64
-        Bool       bool
-        Nil        interface{}
-        unexported string
-    }
-
-    cases := []interface{}{
-        true,
-        1,
-        0.1,
-        map[string]int{
-            "a": 1,
-            "b": 2,
-        },
-        &Struct{
-            Str:   "test",
-            Int:   1,
-            Float: 0.1,
-            Bool:  true,
-            Nil:   nil,
-            // unexported: "can't be cloned",
-        },
-    }
-
-    for _, item := range cases {
-        cloned := convertor.DeepClone(item)
-
-        isPointerEqual := &cloned == &item
-        fmt.Println(cloned, isPointerEqual)
-    }
-
-    // Output:
-    // true false
-    // 1 false
-    // 0.1 false
-    // map[a:1 b:2] false
-    // &{test 1 0.1 true <nil> } false
-}
-```

 ### <span id="CopyProperties">CopyProperties</span>

@@ -779,41 +717,6 @@ func main() {
 }
 ```

-### <span id="ToInterface">ToInterface</span>
-
-<p>Converts reflect value to its interface type.</p>
-
-<b>Signature:</b>
-
-```go
-func ToInterface(v reflect.Value) (value interface{}, ok bool)
-```
-
-<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/syqw0-WG7Xd)</span></b>
-
-```go
-package main
-
-import (
-    "fmt"
-    "github.com/duke-git/lancet/v2/convertor"
-)
-
-func main() {
-    val := reflect.ValueOf("abc")
-    iVal, ok := convertor.ToInterface(val)
-
-    fmt.Printf("%T\n", iVal)
-    fmt.Printf("%v\n", iVal)
-    fmt.Println(ok)
-
-    // Output:
-    // string
-    // abc
-    // true    
-}
-```
-
 ### <span id="Utf8ToGbk">Utf8ToGbk</span>

 <p>Converts utf8 encoding data to GBK encoding data.</p>
@@ -883,7 +786,7 @@ func main() {

 ### <span id="ToStdBase64">ToStdBase64</span>

-<p>Convert a value to a string encoded in standard Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON-formatted string.</p>
+<p>Convert a value to a string encoded in standard Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON formatted string.</p>

 <b>Signature:</b>

@@ -891,7 +794,7 @@ func main() {
 func ToStdBase64(value any) string
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/_fLJqJD3NMo)</span></b>

 ```go
 package main
@@ -953,9 +856,11 @@ func main() {

 ```

+
+
 ### <span id="ToUrlBase64">ToUrlBase64</span>

-<p>Convert a value to a string encoded in url Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON-formatted string.</p>
+<p>Convert a value to a string encoded in url Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON formatted string.</p>

 <b>Signature:</b>

@@ -963,7 +868,7 @@ func main() {
 func ToUrlBase64(value any) string
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/C_d0GlvEeUR)</span></b>

 ```go
 package main
@@ -1024,7 +929,7 @@ func main() {

 ### <span id="ToRawStdBase64">ToRawStdBase64</span>

-<p>Convert a value to a string encoded in raw standard Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON-formatted string.</p>
+<p>Convert a value to a string encoded in raw standard Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON formatted string.</p>

 <b>Signature:</b>

@@ -1032,7 +937,7 @@ func main() {
 func ToRawStdBase64(value any) string
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/wSAr3sfkDcv)</span></b>

 ```go
 package main
@@ -1045,7 +950,7 @@ import (
 func main() {

    stringVal := "hello"
-    afterEncode = convertor.ToRawStdBase64(stringVal)
+    afterEncode := convertor.ToRawStdBase64(stringVal)
    fmt.Println(afterEncode)

    byteSliceVal := []byte("hello")
@@ -1088,7 +993,7 @@ func main() {

 ### <span id="ToRawUrlBase64">ToRawUrlBase64</span>

-<p> Convert a value to a string encoded in raw url Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON-formatted string.</p>
+<p> Convert a value to a string encoded in raw url Base64. Error data of type "error" will also be encoded, and complex structures will be converted to a JSON formatted string.</p>

 <b>Signature:</b>

@@ -1096,7 +1001,7 @@ func main() {
 func ToRawUrlBase64(value any) string
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/HwdDPFcza1O)</span></b>

 ```go
 package main
@@ -1109,7 +1014,7 @@ import (
 func main() {

    stringVal := "hello"
-    afterEncode = convertor.ToRawUrlBase64(stringVal)
+    afterEncode := convertor.ToRawUrlBase64(stringVal)
    fmt.Println(afterEncode)

    byteSliceVal := []byte("hello")
@@ -1132,11 +1037,11 @@ func main() {
    fmt.Println(afterEncode)

    boolVal := true
-    afterEncode = convertor.ToRawStdBase64(boolVal)
+    afterEncode = convertor.ToRawUrlBase64(boolVal)
    fmt.Println(afterEncode)

    errVal := errors.New("err")
-    afterEncode = convertor.ToRawStdBase64(errVal)
+    afterEncode = convertor.ToRawUrlBase64(errVal)
    fmt.Println(afterEncode)

    // Output:
@@ -1148,4 +1053,67 @@ func main() {
    // dHJ1ZQ
    // ZXJy
 }
+```
+
+### <span id="DeepClone">DeepClone</span>
+
+<p>Creates a deep copy of passed item, can't clone unexported field of struct.</p>
+
+<b>Signature:</b>
+
+```go
+func DeepClone[T any](src T) T
+```
+
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/j4DP5dquxnk)</span></b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/convertor"
+)
+
+func main() {
+    type Struct struct {
+        Str        string
+        Int        int
+        Float      float64
+        Bool       bool
+        Nil        interface{}
+        unexported string
+    }
+
+    cases := []interface{}{
+        true,
+        1,
+        0.1,
+        map[string]int{
+            "a": 1,
+            "b": 2,
+        },
+        &Struct{
+            Str:   "test",
+            Int:   1,
+            Float: 0.1,
+            Bool:  true,
+            Nil:   nil,
+        },
+    }
+
+    for _, item := range cases {
+        cloned := convertor.DeepClone(item)
+
+        isPointerEqual := &cloned == &item
+        fmt.Println(cloned, isPointerEqual)
+    }
+
+    // Output:
+    // true false
+    // 1 false
+    // 0.1 false
+    // map[a:1 b:2] false
+    // &{test 1 0.1 true <nil> } false
+}
 ```
--- a/docs/en/api/packages/datastructure/hashmap.md
+++ b/docs/en/api/packages/datastructure/hashmap.md
@@ -32,6 +32,7 @@ import (
 - [Iterate](#Iterate)
 - [Keys](#Keys)
 - [Values](#Values)
+- [FilterByValue](#FilterByValue)

 <div STYLE="page-break-after: always;"></div>

@@ -311,4 +312,77 @@ func main() {
 }
 ```

+### <span id="FilterByValue">FilterByValue</span>

+<p>Returns a filtered HashMap.</p>
+
+<b>Signature:</b>
+
+```go
+func (hm *HashMap) FilterByValue(perdicate func(value any) bool) *HashMap
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    hashmap "github.com/duke-git/lancet/v2/datastructure/hashmap"
+)
+
+func main() {
+    hm := hashmap.NewHashMap()
+
+    hm.Put("a", 1)
+    hm.Put("b", 2)
+    hm.Put("c", 3)
+    hm.Put("d", 4)
+    hm.Put("e", 5)
+    hm.Put("f", 6)
+
+    filteredHM := hm.FilterByValue(func(value any) bool {
+        return value.(int) == 1 || value.(int) == 3
+    })
+
+    fmt.Println(filteredHM.Size()) //2
+}
+```
+
+
+
+### <span id="ToInterface">ToInterface</span>
+
+<p>Converts reflect value to its interface type.</p>
+
+<b>Signature:</b>
+
+```go
+func ToInterface(v reflect.Value) (value interface{}, ok bool)
+```
+
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/syqw0-WG7Xd)</span></b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/convertor"
+)
+
+func main() {
+    val := reflect.ValueOf("abc")
+    iVal, ok := convertor.ToInterface(val)
+
+    fmt.Printf("%T\n", iVal)
+    fmt.Printf("%v\n", iVal)
+    fmt.Println(ok)
+
+    // Output:
+    // string
+    // abc
+    // true    
+}
+```
--- a/docs/en/api/packages/fileutil.md
+++ b/docs/en/api/packages/fileutil.md
@@ -167,7 +167,7 @@ func main() {

 ### <span id="CopyDir">CopyDir</span>

-<p>copy	src directory to dst directory, it will copy all files and directories recursively. the access permission will be the same as the source directory. if dstPath exists, it will return an error.</p>
+<p>Copy	src directory to dst directory, it will copy all files and directories recursively. the access permission will be the same as the source directory. if dstPath exists, it will return an error.</p>

 <b>Signature:</b>

@@ -974,7 +974,7 @@ func main() {
 func ChunkRead(file *os.File, offset int64, size int, bufPool *sync.Pool) ([]string, error)
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/r0hPmKWhsgf)</span></b>

 ```go
 package main
@@ -1033,7 +1033,7 @@ func main() {
 func ParallelChunkRead(filePath string, linesCh chan<- []string, chunkSizeMB, maxGoroutine int) error
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/teMXnCsdSEw)</span></b>

 ```go
 package main
--- a/docs/en/api/packages/function.md
+++ b/docs/en/api/packages/function.md
@@ -423,7 +423,7 @@ func longRunningTask() {
 func And[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/dTBHJMQ0zD2)</span></b>

 ```go
 package main
@@ -460,7 +460,7 @@ func main() {
 func Or[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/LitCIsDFNDA)</span></b>

 ```go
 package main
@@ -495,7 +495,7 @@ func main() {
 func Negate[T any](predicate func(T) bool) func(T) bool
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/jbI8BtgFnVE)</span></b>

 ```go
 package main
@@ -535,7 +535,7 @@ func main() {
 func Nor[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/2KdCoBEOq84)</span></b>

 ```go
 package main
@@ -577,7 +577,7 @@ func main() {
 func Nand[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/Rb-FdNGpgSO)</span></b>

 ```go
 package main
@@ -614,7 +614,7 @@ func main() {
 func Xnor[T any](predicates ...func(T) bool) func(T) bool
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/FJxko8SFbqc)</span></b>

 ```go
 package main
@@ -643,9 +643,7 @@ func main() {

 ### <span id="AcceptIf">AcceptIf</span>

-<p>AcceptIf returns another function of the same signature as the apply function but also includes a bool value to indicate success or failure. 
-A predicate function that takes an argument of type T and returns a bool.
-An apply function that also takes an argument of type T and returns a modified value of the same type.</p>
+<p>AcceptIf returns another function of the same signature as the apply function but also includes a bool value to indicate success or failure. A predicate function that takes an argument of type T and returns a bool. An apply function that also takes an argument of type T and returns a modified value of the same type.</p>

 <b>Signature:</b>

@@ -653,7 +651,7 @@ An apply function that also takes an argument of type T and returns a modified v
 func AcceptIf[T any](predicate func(T) bool, apply func(T) T) func(T) (T, bool)
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/XlXHHtzCf7d)</span></b>

 ```go
 package main
@@ -665,8 +663,8 @@ import (

 func main() {

-    adder := AcceptIf(
-        And(
+    adder := function.AcceptIf(
+        function.And(
            func(x int) bool {
                return x > 10
            }, func(x int) bool {
--- a/docs/en/api/packages/mathutil.md
+++ b/docs/en/api/packages/mathutil.md
@@ -508,7 +508,7 @@ func main() {
 func CeilToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/8hOeSADZPCo)</span></b>

 ```go
 package main
@@ -544,7 +544,7 @@ func main() {
 func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/wy5bYEyUKKG)</span></b>

 ```go
 package main
@@ -577,10 +577,10 @@ func main() {
 <b>Signature:</b>

 ```go
-func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+func FloorToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/vbCBrQHZEED)</span></b>

 ```go
 package main
@@ -613,10 +613,10 @@ func main() {
 <b>Signature:</b>

 ```go
-func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+func FloorToString[T constraints.Float | constraints.Integer](x T, n int) string
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/Qk9KPd2IdDb)</span></b>

 ```go
 package main
@@ -1130,7 +1130,7 @@ func main() {

 ### <span id="Div">Div</span>

-<p>returns the result of x divided by y.</p>
+<p>Returns the result of x divided by y.</p>

 <b>Signature:</b>

@@ -1138,7 +1138,7 @@ func main() {
 func Div[T constraints.Float | constraints.Integer](x T, y T) float64
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/WLxDdGXXYat)</span></b>

 ```go
 package main
--- a/docs/en/api/packages/slice.md
+++ b/docs/en/api/packages/slice.md
@@ -93,6 +93,8 @@ import (
 -   [KeyBy](#KeyBy)
 -   [Join](#Join)
 -   [Partition](#Partition)
+-   [SetToDefaultIf](#SetToDefaultIf)
+-   [Break](#Break)

 <div STYLE="page-break-after: always;"></div>

@@ -2577,7 +2579,7 @@ func main() {
 func SetToDefaultIf[T any](slice []T, predicate func(T) bool) ([]T, int)
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[Run](https://go.dev/play/p/9AXGlPRC0-A)</span></b>

 ```go
 import (
@@ -2596,4 +2598,37 @@ func main() {
 	// [ b  c d ]
 	// 3
 }
+```
+
+### <span id="Break">Break</span>
+
+<p>Splits a slice into two based on a predicate function. It starts appending to the second slice after the first element that matches the predicate. All elements after the first match are included in the second slice, regardless of whether they match the predicate or not.</p>
+
+<b>Signature:</b>
+
+```go
+func Break[T any](values []T, predicate func(T) bool) ([]T, []T)
+```
+
+<b>Example:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/slice"
+)
+
+func main() {
+    nums := []int{1, 2, 3, 4, 5}
+    even := func(n int) bool { return n%2 == 0 }
+
+    resultEven, resultAfterFirstEven := slice.Break(nums, even)
+    
+    fmt.Println(resultEven)
+    fmt.Println(resultAfterFirstEven)
+    
+    // Output:
+    // [1]
+    // [2 3 4 5]
+}
 ```
--- a/docs/en/api/packages/strutil.md
+++ b/docs/en/api/packages/strutil.md
@@ -1477,7 +1477,7 @@ func main() {
 func SubInBetween(str string, start string, end string) string
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/EDbaRvjeNsv)</span></b>

 ```go
 import (
@@ -1507,10 +1507,10 @@ func main() {
 <b>Signature:</b>

 ```go
-HammingDistance(a, b string) (int, error)
+func HammingDistance(a, b string) (int, error)
 ```

-<b>Example:</b>
+<b>Example:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/glNdQEA9HUi)</span></b>

 ```go
 import (
--- a/fileutil/file.go
+++ b/fileutil/file.go
@@ -869,7 +869,7 @@ func isCsvSupportedType(v interface{}) bool {
 }

 // ChunkRead reads a block from the file at the specified offset and returns all lines within the block
-// Play: todo
+// Play: https://go.dev/play/p/r0hPmKWhsgf
 func ChunkRead(file *os.File, offset int64, size int, bufPool *sync.Pool) ([]string, error) {
 	buf := bufPool.Get().([]byte)[:size] // 从Pool获取缓冲区并调整大小
 	n, err := file.ReadAt(buf, offset)   // 从指定偏移读取数据到缓冲区
@@ -901,7 +901,7 @@ func ChunkRead(file *os.File, offset int64, size int, bufPool *sync.Pool) ([]str
 // chunkSizeMB 分块的大小（单位MB，设置为0时使用默认100MB）,设置过大反而不利，视情调整
 // maxGoroutine 并发读取分块的数量，设置为0时使用CPU核心数
 // linesCh用于接收返回结果的通道。
-// Play: todo
+// Play: https://go.dev/play/p/teMXnCsdSEw
 func ParallelChunkRead(filePath string, linesCh chan<- []string, chunkSizeMB, maxGoroutine int) error {
 	if chunkSizeMB == 0 {
 		chunkSizeMB = 100
--- a/function/function.go
+++ b/function/function.go
@@ -139,6 +139,7 @@ func Pipeline[T any](funcs ...func(T) T) func(T) T {
 // AcceptIf returns another function of the same signature as the apply function but also includes a bool value to indicate success or failure.
 // A predicate function that takes an argument of type T and returns a bool.
 // An apply function that also takes an argument of type T and returns a modified value of the same type.
+// Play: https://go.dev/play/p/XlXHHtzCf7d
 func AcceptIf[T any](predicate func(T) bool, apply func(T) T) func(T) (T, bool) {
 	if predicate == nil {
 		panic("programming error: predicate must be not nil")
--- a/function/predicate.go
+++ b/function/predicate.go
@@ -2,6 +2,7 @@ package function

 // And returns a composed predicate that represents the logical AND of a list of predicates.
 // It evaluates to true only if all predicates evaluate to true for the given value.
+// Play: https://go.dev/play/p/dTBHJMQ0zD2
 func And[T any](predicates ...func(T) bool) func(T) bool {
 	if len(predicates) < 2 {
 		panic("programming error: predicates count must be at least 2")
@@ -18,6 +19,7 @@ func And[T any](predicates ...func(T) bool) func(T) bool {

 // Nand returns a composed predicate that represents the logical NAND of a list of predicates.
 // It evaluates to true only if all predicates evaluate to false for the given value.
+// Play: https://go.dev/play/p/Rb-FdNGpgSO
 func Nand[T any](predicates ...func(T) bool) func(T) bool {
 	if len(predicates) < 2 {
 		panic("programming error: predicates count must be at least 2")
@@ -33,6 +35,7 @@ func Nand[T any](predicates ...func(T) bool) func(T) bool {
 }

 // Negate returns a predicate that represents the logical negation of this predicate.
+// Play: https://go.dev/play/p/jbI8BtgFnVE
 func Negate[T any](predicate func(T) bool) func(T) bool {
 	return func(value T) bool {
 		return !predicate(value)
@@ -41,6 +44,7 @@ func Negate[T any](predicate func(T) bool) func(T) bool {

 // Or returns a composed predicate that represents the logical OR of a list of predicates.
 // It evaluates to true if at least one of the predicates evaluates to true for the given value.
+// Play: https://go.dev/play/p/LitCIsDFNDA
 func Or[T any](predicates ...func(T) bool) func(T) bool {
 	if len(predicates) < 2 {
 		panic("programming error: predicates count must be at least 2")
@@ -57,6 +61,7 @@ func Or[T any](predicates ...func(T) bool) func(T) bool {

 // Nor returns a composed predicate that represents the logical NOR of a list of predicates.
 // It evaluates to true only if all predicates evaluate to false for the given value.
+// Play: https://go.dev/play/p/2KdCoBEOq84
 func Nor[T any](predicates ...func(T) bool) func(T) bool {
 	if len(predicates) < 2 {
 		panic("programming error: predicates count must be at least 2")
@@ -73,6 +78,7 @@ func Nor[T any](predicates ...func(T) bool) func(T) bool {

 // Xnor returns a composed predicate that represents the logical XNOR of a list of predicates.
 // It evaluates to true only if all predicates evaluate to true or false for the given value.
+// Play: https://go.dev/play/p/FJxko8SFbqc
 func Xnor[T any](predicates ...func(T) bool) func(T) bool {
 	if len(predicates) < 2 {
 		panic("programming error: predicates count must be at least 2")
--- a/mathutil/mathutil.go
+++ b/mathutil/mathutil.go
@@ -101,7 +101,7 @@ func TruncRound[T constraints.Float | constraints.Integer](x T, n int) T {
 }

 // FloorToFloat round down to n decimal places.
-// Play: todo
+// Play: https://go.dev/play/p/vbCBrQHZEED
 func FloorToFloat[T constraints.Float | constraints.Integer](x T, n int) float64 {
 	tmp := math.Pow(10.0, float64(n))
 	x *= T(tmp)
@@ -110,7 +110,7 @@ func FloorToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
 }

 // FloorToString round down to n decimal places.
-// Play: todo
+// Play: https://go.dev/play/p/Qk9KPd2IdDb
 func FloorToString[T constraints.Float | constraints.Integer](x T, n int) string {
 	tmp := math.Pow(10.0, float64(n))
 	x *= T(tmp)
@@ -120,7 +120,7 @@ func FloorToString[T constraints.Float | constraints.Integer](x T, n int) string
 }

 // CeilToFloat round up to n decimal places.
-// Play: todo
+// Play: https://go.dev/play/p/8hOeSADZPCo
 func CeilToFloat[T constraints.Float | constraints.Integer](x T, n int) float64 {
 	tmp := math.Pow(10.0, float64(n))
 	x *= T(tmp)
@@ -129,7 +129,7 @@ func CeilToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
 }

 // CeilToString round up to n decimal places.
-// Play: todo
+// Play: https://go.dev/play/p/wy5bYEyUKKG
 func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string {
 	tmp := math.Pow(10.0, float64(n))
 	x *= T(tmp)
@@ -391,7 +391,7 @@ func Abs[T constraints.Integer | constraints.Float](x T) T {
 }

 // Div returns the result of x divided by y.
-// Play: todo
+// Play: https://go.dev/play/p/WLxDdGXXYat
 func Div[T constraints.Float | constraints.Integer](x T, y T) float64 {
 	return float64(x) / float64(y)
 }
--- a/slice/slice.go
+++ b/slice/slice.go
@@ -1173,7 +1173,7 @@ func AppendIfAbsent[T comparable](slice []T, item T) []T {
 // SetToDefaultIf sets elements to their default value if they match the given predicate.
 // It retains the positions of the elements in the slice.
 // It returns slice of T and the count of modified slice items
-// Play: todo
+// Play: https://go.dev/play/p/9AXGlPRC0-A
 func SetToDefaultIf[T any](slice []T, predicate func(T) bool) ([]T, int) {
 	var count int
 	for i := 0; i < len(slice); i++ {
@@ -1239,6 +1239,30 @@ func Partition[T any](slice []T, predicates ...func(item T) bool) [][]T {
 	return result
 }

+// Breaks a list into two parts at the point where the predicate for the first time is true.
+// Play: Todo
+func Break[T any](values []T, predicate func(T) bool) ([]T, []T) {
+	a := make([]T, 0)
+	b := make([]T, 0)
+	if len(values) == 0 {
+		return a, b
+	}
+	matched := false
+	for _, value := range values {
+
+		if !matched && predicate(value) {
+			matched = true
+		}
+
+		if matched {
+			b = append(b, value)
+		} else {
+			a = append(a, value)
+		}
+	}
+	return a, b
+}
+
 // Random get a random item of slice, return idx=-1 when slice is empty
 // Play: https://go.dev/play/p/UzpGQptWppw
 func Random[T any](slice []T) (val T, idx int) {
--- a/slice/slice_example_test.go
+++ b/slice/slice_example_test.go
@@ -1112,3 +1112,16 @@ func ExampleSetToDefaultIf() {
 	// [ b  c d ]
 	// 3
 }
+
+func ExampleBreak() {
+	nums := []int{1, 2, 3, 4, 5}
+	even := func(n int) bool { return n%2 == 0 }
+
+	resultEven, resultAfterFirstEven := Break(nums, even)
+	fmt.Println(resultEven)
+	fmt.Println(resultAfterFirstEven)
+
+	// Output:
+	// [1]
+	// [2 3 4 5]
+}
--- a/slice/slice_test.go
+++ b/slice/slice_test.go
@@ -1357,3 +1357,42 @@ func TestSetToDefaultIf(t *testing.T) {
 		assert.Equal(2, count)
 	})
 }
+
+func TestBreak(t *testing.T) {
+	t.Parallel()
+
+	assert := internal.NewAssert(t, "TestBreak")
+
+	// Test with integers
+	nums := []int{1, 2, 3, 4, 5}
+	even := func(n int) bool { return n%2 == 0 }
+
+	resultEven, resultAfterFirstEven := Break(nums, even)
+	assert.Equal([]int{1}, resultEven)
+	assert.Equal([]int{2, 3, 4, 5}, resultAfterFirstEven)
+
+	// Test with strings
+	strings := []string{"apple", "banana", "cherry", "date", "elderberry"}
+	startsWithA := func(s string) bool { return s[0] == 'a' }
+
+	resultStartsWithA, resultAfterFirstStartsWithA := Break(strings, startsWithA)
+	assert.Equal([]string{}, resultStartsWithA)
+	assert.Equal([]string{"apple", "banana", "cherry", "date", "elderberry"}, resultAfterFirstStartsWithA)
+
+	// Test with empty slice
+	emptySlice := []int{}
+	resultEmpty, _ := Break(emptySlice, even)
+	assert.Equal([]int{}, resultEmpty)
+
+	// Test with all elements satisfying the predicate
+	allEven := []int{2, 4, 6, 8, 10}
+	emptyResult, resultAllEven := Break(allEven, even)
+	assert.Equal([]int{2, 4, 6, 8, 10}, resultAllEven)
+	assert.Equal([]int{}, emptyResult)
+
+	// Test with no elements satisfying the predicate
+	allOdd := []int{1, 3, 5, 7, 9}
+	resultAllOdd, emptyResult := Break(allOdd, even)
+	assert.Equal([]int{1, 3, 5, 7, 9}, resultAllOdd)
+	assert.Equal([]int{}, emptyResult)
+}
--- a/strutil/string.go
+++ b/strutil/string.go
@@ -585,7 +585,7 @@ func RemoveWhiteSpace(str string, repalceAll bool) string {
 }

 // SubInBetween return substring between the start and end position(excluded) of source string.
-// Play: todo
+// Play: https://go.dev/play/p/EDbaRvjeNsv
 func SubInBetween(str string, start string, end string) string {
 	if _, after, ok := strings.Cut(str, start); ok {
 		if before, _, ok := strings.Cut(after, end); ok {
@@ -599,7 +599,7 @@ func SubInBetween(str string, start string, end string) string {
 // HammingDistance calculates the Hamming distance between two strings.
 // The Hamming distance is the number of positions at which the corresponding symbols are different.
 // This func returns an error if the input strings are of unequal lengths.
-// Play: todo
+// Play: https://go.dev/play/p/glNdQEA9HUi
 func HammingDistance(a, b string) (int, error) {
 	if len(a) != len(b) {
 		return -1, errors.New("a length and b length are unequal")
Author	SHA1	Message	Date
dudaodong	73c97af7d8	doc: update doc for Break function	2024-03-08 21:39:06 +08:00
donutloop	5e8a065eaa	Slice: break (#200 ) Splits a slice into two based on a predicate function. It starts appending to the second slice after the first element that matches the predicate. All elements after the first match are included in the second slice, regardless of whether they match the predicate or not.	2024-03-07 14:11:19 +08:00
dudaodong	aa74400607	doc: fix doc text error	2024-03-06 16:19:20 +08:00
dudaodong	a6eaaef563	doc: add go playground demo	2024-03-06 15:28:55 +08:00
dudaodong	1b31014f81	doc: add go playground demo	2024-03-06 14:52:35 +08:00