doc: add play ground demo

2026-03-01 00:35:28 +08:00 · 2024-10-09 16:56:56 +08:00
parent 5d6ab72059
commit 213e2b4ead
30 changed files with 293 additions and 275 deletions
--- a/README_zh-CN.md
+++ b/README_zh-CN.md
@@ -365,10 +365,10 @@ import "github.com/duke-git/lancet/v2/cryptor"
    [[play](https://go.dev/play/p/VtHxtkUj-3F)]
 -   **<big>AesGcmEncrypt</big>** : 使用 AES GCM 算法模式加密数据。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/cryptor.md#AesGcmEncrypt)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/rUt0-DmsPCs)]
 -   **<big>AesGcmDecrypt</big>** : 使用 AES GCM 算法模式解密数据。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/cryptor.md#AesGcmDecrypt)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/rUt0-DmsPCs)]
 -   **<big>Base64StdEncode</big>** : 将字符串 base64 编码。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/cryptor.md#Base64StdEncode)]
    [[play](https://go.dev/play/p/VOaUyQUreoK)]
@@ -614,13 +614,13 @@ import "github.com/duke-git/lancet/v2/datetime"
    [[play](https://go.dev/play/p/A9Oq_COrcCF)]
 -   **<big>TrackFuncTime</big>** : 测试函数执行时间。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/datetime.md#TrackFuncTime)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/QBSEdfXHPTp)]
 -   **<big>DaysBetween</big>** : 返回两个日期之间的天数差。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/datetime.md#DaysBetween)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/qD6qGb3TbOy)]
 -   **<big>GenerateDatetimesBetween</big>** : 生成从start到end的所有日期时间的字符串列表。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/datetime.md#GenerateDatetimesBetween)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/6kHBpAxD9ZC)]


 <h3 id="datastructure"> 8. datastructure 包含一些普通的数据结构实现。例如：list, linklist, stack, queue, set, tree, graph。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>
@@ -814,10 +814,10 @@ import "github.com/duke-git/lancet/v2/function"
    [[play](https://go.dev/play/p/absuEGB_GN7)]
 -   **<big>Debounce</big>** : 创建一个函数的去抖动版本。该去抖动函数仅在上次调用后的指定延迟时间过去之后才会调用原始函数。支持取消去抖动。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Debounce)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/-dGFrYn_1Zi)]
 -   **<big>Throttle</big>** : 创建一个函数的节流版本。返回的函数保证在每个时间间隔内最多只会被调用一次。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Throttle)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/HpoMov-tJSN)]
 -   **<big>Schedule</big>** : 每次持续时间调用函数，直到关闭返回的 channel。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/function.md#Schedule)]
    [[play](https://go.dev/play/p/hbON-Xeyn5N)]
@@ -939,58 +939,58 @@ import "github.com/duke-git/lancet/v2/maputil"
    [[play](https://go.dev/play/p/0nlPo6YLdt3)]
 -   **<big>NewOrderedMap</big>** : 创建有序映射。有序映射是键值对的集合，其中键是唯一的，并且保留键插入的顺序。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#NewOrderedMap)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/Y4ZJ_oOc1FU)]
 -   **<big>OrderedMap_Set</big>** : 设置给定的键值对。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Set)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/Y4ZJ_oOc1FU)]
 -   **<big>OrderedMap_Get</big>** : 返回给定键的值。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Get)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/Y4ZJ_oOc1FU)]
 -   **<big>OrderedMap_Delete</big>** : 删除给定键的键值对。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Delete)]
-    [[play](todo)]
+    [[play](ttps://go.dev/play/p/5bIi4yaZ3K-)]
 -   **<big>OrderedMap_Clear</big>** : 清空map数据。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Clear)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/8LwoJyEfuFr)]
 -   **<big>OrderedMap_Front</big>** : 返回第一个键值对。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Front)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/ty57XSimpoe)]
 -   **<big>OrderedMap_Back</big>** : 返回最后一个键值对。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Back)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/rQMjp1yQmpa)]
 -   **<big>OrderedMap_Range</big>** : 为每个键值对调用给定的函数。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Range)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/U-KpORhc7LZ)]
 -   **<big>OrderedMap_Keys</big>** : 按顺序返回键的切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Keys)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/Vv_y9ExKclA)]
 -   **<big>OrderedMap_Values</big>** : 按顺序返回值的切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Values)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/TWj5n1-PUfx)]
 -   **<big>OrderedMap_Elements</big>** : 按顺序返回键值对。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Elements)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/4BHG4kKz6bB)]
 -   **<big>OrderedMap_Len</big>** : 返回键值对的数量。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Len)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/cLe6z2VX5N-)]
 -   **<big>OrderedMap_Contains</big>** : 如果给定的键存在则返回true。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Contains)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/QuwqqnzwDNX)]
 -   **<big>OrderedMap_Iter</big>** : 返回按顺序产生键值对的通道。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_Iter)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/tlq2tdvicPt)]
 -   **<big>OrderedMap_ReverseIter</big>** : 返回以相反顺序产生键值对的通道。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_ReverseIter)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/8Q0ssg6hZzO)]
 -   **<big>OrderedMap_SortByKey</big>** : 使用传入的比较函数排序map key。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_SortByKey)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/N7hjD_alZPq)]
 -   **<big>OrderedMap_MarshalJSON</big>** : 实现json.Marshaler接口。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_MarshalJSON)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/C-wAwydIAC7)]
 -   **<big>OrderedMap_UnmarshalJSON</big>** : 实现json.Unmarshaler接口。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#OrderedMap_UnmarshalJSON)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/8C3MvJ3-mut)]
 -   **<big>NewConcurrentMap</big>** : ConcurrentMap 协程安全的 map 结构。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#NewConcurrentMap)]
    [[play](https://go.dev/play/p/3PenTPETJT0)]
@@ -1017,10 +1017,10 @@ import "github.com/duke-git/lancet/v2/maputil"
    [[play](https://go.dev/play/p/iqcy7P8P0Pr)]
 -   **<big>SortByKey</big>** : 对传入的map根据key进行排序。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#SortByKey)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/PVdmBSnm6P_W)]
 -   **<big>GetOrDefault</big>** : 返回给定键的值，如果键不存在，则返回默认值。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/maputil.md#GetOrDefault)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/99QjSYSBdiM)]

 <h3 id="mathutil"> 13. mathutil 包实现了一些数学计算的函数。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

@@ -1265,22 +1265,22 @@ import "github.com/duke-git/lancet/v2/random"
    [[play](https://go.dev/play/p/uBkRSOz73Ec)]
 -   **<big>RandStringSlice</big>** : 生成随机字符串slice。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/random.md#RandStringSlice)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/2_-PiDv3tGn)]
 -   **<big>RandBool</big>** : 生成随机bool值(true or false)。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/random.md#RandBool)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/to6BLc26wBv)]
 -   **<big>RandBoolSlice</big>** : 生成特定长度的随机bool slice。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/random.md#RandBoolSlice)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/o-VSjPjnILI)]
 -   **<big>RandIntSlice</big>** : 生成一个特定长度的随机int切片，数值范围[min, max)。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/random.md#RandIntSlice)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/GATTQ5xTEG8)]
 -   **<big>RandFromGivenSlice</big>** : 从给定切片中随机生成元素。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/random.md#RandFromGivenSlice)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/UrkWueF6yYo)]
 -   **<big>RandSliceFromGivenSlice</big>** : 从给定切片中生成长度为 num 的随机切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/random.md#RandSliceFromGivenSlice)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/68UikN9d6VT)]


 <h3 id="retry"> 17. retry 重试执行函数直到函数运行成功或被 context cancel。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>
@@ -1420,7 +1420,7 @@ import "github.com/duke-git/lancet/v2/slice"
    [[play](https://go.dev/play/p/DrPaa4YsHRF)]
 -   **<big>ForEachConcurrent</big>** : 对slice并发执行foreach操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#ForEachConcurrent)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/kT4XW7DKVoV)]
 -   **<big>ForEachWithBreak</big>** : 遍历切片的元素并为每个元素调用 iteratee 函数，当 iteratee 函数返回 false 时，终止遍历。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#ForEachWithBreak)]
    [[play](https://go.dev/play/p/qScs39f3D9W)]
@@ -1453,7 +1453,7 @@ import "github.com/duke-git/lancet/v2/slice"
    [[play](https://go.dev/play/p/biaTefqPquw)]
 -   **<big>MapConcurrent</big>** : 对slice并发执行map操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#MapConcurrent)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/H1ehfPkPen0)]
 -   **<big>Merge</big>** : 合并多个切片（不会消除重复元素)。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#Merge)]
    [[play](https://go.dev/play/p/lbjFp784r9N)]
@@ -1471,7 +1471,7 @@ import "github.com/duke-git/lancet/v2/slice"
    [[play](https://go.dev/play/p/qT9dZC03A1K)]
 -   **<big>ReduceConcurrent</big>** : 对切片元素执行并发reduce操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#ReduceConcurrent)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/Tjwe6OtaG07)]
 -   **<big>Replace</big>** : 返回切片的副本，其中前 n 个不重叠的 old 替换为 new。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#Replace)]
    [[play](https://go.dev/play/p/P5mZp7IhOFo)]
@@ -1525,16 +1525,16 @@ import "github.com/duke-git/lancet/v2/slice"
    [[play](https://go.dev/play/p/AXw0R3ZTE6a)]
 -   **<big>UniqueBy</big>** : 根据迭代函数返回的值，从输入切片中移除重复元素。此函数保持元素的顺序。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#UniqueBy)]
-    [[play](https://go.dev/play/p/UR323iZLDpv)]
+    [[play](https://go.dev/play/p/GY7JE4yikrl)]
 -   **<big>UniqueByComparator</big>** : 使用提供的比较器函数从输入切片中移除重复元素。此函数保持元素的顺序。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#UniqueByComparator)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/rwSacr-ZHsR)]
 -   **<big>UniqueByField</big>** : 根据struct字段对struct切片去重复。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#UniqueByField)]
    [[play](https://go.dev/play/p/6cifcZSPIGu)]
 -   **<big>UniqueByConcurrent</big>** : 并发的从输入切片中移除重复元素，结果保持元素的顺序。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#UniqueByConcurrent)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/wXZ7LcYRMGL)]
 -   **<big>Union</big>** : 合并多个切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#Union)]
    [[play](https://go.dev/play/p/hfXV1iRIZOf)]
@@ -1571,7 +1571,7 @@ import "github.com/duke-git/lancet/v2/slice"
    [[play](https://go.dev/play/p/jlQVoelLl2k)]
 -   **<big>Frequency</big>** : 计算切片中每个元素出现的频率。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#Frequency)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/CW3UVNdUZOq)]


 <h3 id="stream"> 19. stream 流，该包仅验证简单的 stream 实现，功能有限。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>
@@ -1608,7 +1608,7 @@ import "github.com/duke-git/lancet/v2/stream"
    [[play](https://go.dev/play/p/MFlSANo-buc)]
 -   **<big>FilterConcurrent</big>** : 对slice并发执行filter操作。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/stream.md#FilterConcurrent)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/t_pkwerIRVx)]
 -   **<big>Map</big>** : 返回一个 stream，该 stream 由将给定函数应用于源 stream 元素的元素组成。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/stream.md#Map)]
    [[play](https://go.dev/play/p/OtNQUImdYko)]
@@ -1832,19 +1832,22 @@ import "github.com/duke-git/lancet/v2/strutil"
    [[play](https://go.dev/play/p/glNdQEA9HUi)]
 -   **<big>Concat</big>** : 拼接字符串。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#Concat)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/gD52SZHr4Kp)]
 -   **<big>Ellipsis</big>** : 将字符串截断到指定长度，并在末尾添加省略号。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#Ellipsis)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/i1vbdQiQVRR)]
 -   **<big>Shuffle</big>** : 打乱给定字符串中的字符顺序。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#Shuffle)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/iStFwBwyGY7)]
 -   **<big>Rotate</big>** : 按指定的字符数旋转字符串。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#Rotate)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/Kf03iOeT5bd)]
 -   **<big>TemplateReplace</big>** : 将模板字符串中的占位符替换为map中的相应值。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#TemplateReplace)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/cXSuFvyZqv9)]
+-   **<big>RegexMatchAllGroups</big>** : 使用正则表达式匹配字符串中的所有子组并返回结果。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#RegexMatchAllGroups)]
+    [[play](https://go.dev/play/p/JZiu0RXpgN-)]

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

@@ -1883,16 +1886,16 @@ import "github.com/duke-git/lancet/v2/system"
    [[play](https://go.dev/play/p/ml-_XH3gJbW)]
 -   **<big>StartProcess</big>** :创建进程。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/system.md#StartProcess)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/5GVol6ryS_X)]
 -   **<big>StopProcess</big>** : 停止进程。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/system.md#StopProcess)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/jJZhRYGGcmD)]
 -   **<big>KillProcess</big>** : 杀掉进程。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/system.md#KillProcess)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/XKmvV-ExBWa)]
 -   **<big>GetProcessInfo</big>** : 根据进程id获取进程信息。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/system.md#GetProcessInfo)]
-    [[play](todo)]
+    [[play](https://go.dev/play/p/NQDVywEYYx7)]