doc: add play ground demo for v2.3.6

2026-02-08 14:42:27 +08:00 · 2025-05-29 11:50:17 +08:00
parent cdefbde9f5
commit 539078e6b8
23 changed files with 489 additions and 153 deletions
--- a/docs/api/packages/concurrency.md
+++ b/docs/api/packages/concurrency.md
@@ -477,7 +477,7 @@ func main() {
 func NewKeyedLocker[K comparable](ttl time.Duration) *KeyedLocker[K]
 ```

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

 ```go
 package main
@@ -534,7 +534,7 @@ func main() {
 func (l *KeyedLocker[K]) Do(ctx context.Context, key K, fn func()) error
 ```

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

 ```go
 package main
@@ -591,7 +591,7 @@ func main() {
 func NewRWKeyedLocker[K comparable](ttl time.Duration) *RWKeyedLocker[K]
 ```

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

 ```go
 package main
@@ -640,7 +640,7 @@ func main() {
 func (l *RWKeyedLocker[K]) RLock(ctx context.Context, key K, fn func()) error
 ```

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

 ```go
 package main
@@ -689,7 +689,7 @@ func main() {
 func (l *RWKeyedLocker[K]) Lock(ctx context.Context, key K, fn func()) error
 ```

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

 ```go
 package main
@@ -738,7 +738,7 @@ func main() {
 func NewTryKeyedLocker[K comparable]() *TryKeyedLocker[K]
 ```

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

 ```go
 package main
@@ -779,7 +779,7 @@ func main() {
 func (l *TryKeyedLocker[K]) TryLock(key K) bool
 ```

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

 ```go
 package main
@@ -820,7 +820,7 @@ func main() {
 func (l *TryKeyedLocker[K]) Unlock(key K)
 ```

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

 ```go
 package main
--- a/docs/api/packages/cryptor.md
+++ b/docs/api/packages/cryptor.md
@@ -27,7 +27,9 @@ import (
 -   [AesEcbDecrypt](#AesEcbDecrypt)
 -   [AesCbcEncrypt](#AesCbcEncrypt)
 -   [AesCbcDecrypt](#AesCbcDecrypt)
-   [AesCtrCrypt](#AesCtrCrypt)
+-   [AesCtrCrypt<sup>deprecated</sup>](#AesCtrCrypt)
+-   [AesCtrEncrypt](#AesCtrEncrypt)
+-   [AesCtrDecrypt](#AesCtrDecrypt)
 -   [AesCfbEncrypt](#AesCfbEncrypt)
 -   [AesCfbDecrypt](#AesCfbDecrypt)
 -   [AesOfbEncrypt](#AesOfbEncrypt)
@@ -40,7 +42,7 @@ import (
 -   [DesEcbDecrypt](#DesEcbDecrypt)
 -   [DesCbcEncrypt](#DesCbcEncrypt)
 -   [DesCbcDecrypt](#DesCbcDecrypt)
-   [DesCtrCrypt](#DesCtrCrypt)
+-   [DesCtrCrypt<sup>deprecated</sup>](#DesCtrCrypt)
 -   [DesCfbEncrypt](#DesCfbEncrypt)
 -   [DesCfbDecrypt](#DesCfbDecrypt)
 -   [DesOfbEncrypt](#DesOfbEncrypt)
@@ -73,7 +75,6 @@ import (
 -   [RsaSign](#RsaSign)
 -   [RsaVerifySign](#RsaVerifySign)

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

 ## 文档
@@ -248,6 +249,74 @@ func main() {
 }
 ```

+### <span id="AesCtrEncrypt">AesCtrEncrypt</span>
+
+<p>使用AES CTR算法模式加密数据，参数`key`的长度是16, 24 or 32。</p>
+
+<b>函数签名:</b>
+
+```go
+func AesCtrEncrypt(data, key []byte) []byte
+```
+
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/x6pjPAvThRz)</span></b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/cryptor"
+)
+
+func main() {
+    data := "hello"
+    key := "abcdefghijklmnop"
+
+    encrypted := cryptor.AesCtrEncrypt([]byte(data), []byte(key))
+    decrypted := cryptor.AesCtrDecrypt(encrypted, []byte(key))
+
+    fmt.Println(string(decrypted))
+
+    // Output:
+    // hello
+}
+```
+
+### <span id="AesCtrDecrypt">AesCtrDecrypt</span>
+
+<p>使用AES CTR算法模式解密数据，参数`key`的长度是16, 24 or 32。</p>
+
+<b>函数签名:</b>
+
+```go
+func AesCtrDecrypt(encrypted, key []byte) []byte
+```
+
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/x6pjPAvThRz)</span></b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/cryptor"
+)
+
+func main() {
+    data := "hello"
+    key := "abcdefghijklmnop"
+
+    encrypted := cryptor.AesCtrEncrypt([]byte(data), []byte(key))
+    decrypted := cryptor.AesCtrDecrypt(encrypted, []byte(key))
+
+    fmt.Println(string(decrypted))
+
+    // Output:
+    // hello
+}
+```
+
 ### <span id="AesCfbEncrypt">AesCfbEncrypt</span>

 <p>使用AES CFB算法模式加密数据，参数`key`的长度是16, 24 or 32。</p>
@@ -648,6 +717,74 @@ func main() {
 }
 ```

+### <span id="DesCtrEncrypt">DesCtrCrypt</span>
+
+<p>使用DES CTR算法模式加密数据，参数`key`的长度是8</p>
+
+<b>函数签名:</b>
+
+```go
+func DesCtrEncrypt(data, key []byte) []byte
+```
+
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/S6p_WHCgH1d)</span></b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/cryptor"
+)
+
+func main() {
+    data := "hello"
+    key := "abcdefgh"
+
+    encrypted := cryptor.DesCtrEncrypt([]byte(data), []byte(key))
+    decrypted := cryptor.DesCtrDecrypt(encrypted, []byte(key))
+
+    fmt.Println(string(decrypted))
+
+    // Output:
+    // hello
+}
+```
+
+### <span id="DesCtrDecrypt">DesCtrDecrypt</span>
+
+<p>使用DES CTR算法模式加密数据，参数`key`的长度是8</p>
+
+<b>函数签名:</b>
+
+```go
+func DesCtrDecrypt(encrypted, key []byte) []byte
+```
+
+<b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/S6p_WHCgH1d)</span></b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/cryptor"
+)
+
+func main() {
+    data := "hello"
+    key := "abcdefgh"
+
+    encrypted := cryptor.DesCtrEncrypt([]byte(data), []byte(key))
+    decrypted := cryptor.DesCtrDecrypt(encrypted, []byte(key))
+
+    fmt.Println(string(decrypted))
+
+    // Output:
+    // hello
+}
+```
+
 ### <span id="DesCtrCrypt">DesCtrCrypt</span>

 <p>使用DES CTR算法模式加密/解密数据，参数`key`的长度是8</p>
--- a/docs/api/packages/fileutil.md
+++ b/docs/api/packages/fileutil.md
@@ -427,7 +427,7 @@ func main() {
 func RemoveDir(path string, onDelete ...func(path string)) error
 ```

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

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

 ```go
-func ReadFile(path string) (reader io.ReadCloser, closeFn func(), err error) 
+func ReadFile(path string) (reader io.ReadCloser, closeFn func(), err error)
 ```

 <b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/uNep3Tr8fqF)</span></b>
@@ -994,9 +994,9 @@ func main() {
    if err != nil {
        return
    }
-    
+
    fmt.Println(string(dat))
-    
+
    // Output:
    // User-agent: *
    // Disallow: /deny
@@ -1025,7 +1025,7 @@ import (

 func main() {
    const mb = 1024 * 1024
-    const defaultChunkSizeMB = 100 
+    const defaultChunkSizeMB = 100

    // test1.csv file content:
    // Lili,22,female
@@ -1089,7 +1089,7 @@ func main() {
    numParsers := runtime.NumCPU()

    linesCh := make(chan []string, numParsers)
-    
+
    // test1.csv file content:
    // Lili,22,female
    // Jim,21,male
@@ -1114,6 +1114,7 @@ func main() {
    // 2
 }
 ```
+
 ### <span id="GetExeOrDllVersion">GetExeOrDllVersion</span>

 <p>返回exe,dll文件版本号(仅Window平台).</p>
@@ -1143,4 +1144,4 @@ func main() {
    // Output:
    // 3.9.10.19
 }
-```
+```
--- a/docs/api/packages/maputil.md
+++ b/docs/api/packages/maputil.md
@@ -1095,7 +1095,7 @@ func main() {
 <b>函数签名:</b>

 ```go
-func ToSortedSlicesWithComparator[K comparable, V any](m map[K]V, comparator func(a, b K) bool) ([]K, []V) 
+func ToSortedSlicesWithComparator[K comparable, V any](m map[K]V, comparator func(a, b K) bool) ([]K, []V)
 ```

 <b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/0nlPo6YLdt3)</span></b>
@@ -1259,7 +1259,6 @@ func main() {
 }
 ```

-
 ### <span id="OrderedMap_Delete">OrderedMap_Delete</span>

 <p>删除给定键的键值对。</p>
@@ -2192,7 +2191,6 @@ func main() {
 }
 ```

-
 ### <span id="GetOrSet">GetOrSet</span>

 <p>返回给定键的值，如果不存在则设置该值。</p>
@@ -2276,7 +2274,7 @@ func main() {
 <b>函数签名:</b>

 ```go
-func GetOrDefault[K comparable, V any](m map[K]V, key K, defaultValue V) V 
+func GetOrDefault[K comparable, V any](m map[K]V, key K, defaultValue V) V
 ```

 <b>示例:<span style="float:right;display:inline-block;">[运行](https://go.dev/play/p/99QjSYSBdiM)</span></b>
@@ -2319,7 +2317,7 @@ func main() {
 func FindValuesBy[K comparable, V any](m map[K]V, predicate func(key K, value V) bool) []V
 ```

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

 ```go
 package main
@@ -2346,4 +2344,4 @@ func main() {
    // Output:
    // [b d]
 }
-```
+```
--- a/docs/api/packages/netutil.md
+++ b/docs/api/packages/netutil.md
@@ -1044,7 +1044,7 @@ func main() {
 func BuildUrl(scheme, host, path string, query map[string][]string) (string, error)
 ```

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

 ```go
 package main
@@ -1084,7 +1084,7 @@ func main() {
 func AddQueryParams(urlStr string, params map[string][]string) (string, error)
 ```

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

 ```go
 package main
--- a/docs/api/packages/validator.md
+++ b/docs/api/packages/validator.md
@@ -834,7 +834,7 @@ func main() {
 func IsAlphaNumeric(s string) bool
 ```

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

 ```go
 import (