doc: add go playground demo

2026-02-04 12:52:28 +08:00 · 2023-09-11 15:59:35 +08:00
parent b38bb66b34
commit b698fec50f
10 changed files with 166 additions and 112 deletions
--- a/README.md
+++ b/README.md
@@ -1325,6 +1325,9 @@ import "github.com/duke-git/lancet/v2/slice"
 -   **<big>Join</big>** : join the slice item with specify separator.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/slice.md#Join)]
    [[play](https://go.dev/play/p/huKzqwNDD7V)]
+-   **<big>Partition</big>** : partition all slice elements with the evaluation of the given predicate functions.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/slice.md#Partition)]
+    [[play](https://go.dev/play/p/lkQ3Ri2NQhV)]

 <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>

@@ -1826,6 +1829,33 @@ import "github.com/duke-git/lancet/v2/validator"
 -   **<big>IsPrintable</big>** : checks if string is all printable chars.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsPrintable)]
    [[play](https://go.dev/play/p/Pe1FE2gdtTP)]
+-   **<big>IsBin</big>** : check if a give string is a valid binary value or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsBin)]
+    [[play](https://go.dev/play/p/ogPeg2XJH4P)]
+-   **<big>IsHex</big>** : check if a give string is a valid hexadecimal value or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsHex)]
+    [[play](https://go.dev/play/p/M2qpHbEwmm7)]
+-   **<big>IsBase64URL</big>** : check if a give string is a valid URL-safe Base64 encoded string.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsBase64URL)]
+    [[play](https://go.dev/play/p/vhl4mr8GZ6S)]
+-   **<big>IsJWT</big>** : check if a give string is a valid JSON Web Token (JWT).
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsJWT)]
+    [[play](https://go.dev/play/p/R6Op7heJbKI)]
+-   **<big>IsVisa</big>** : check if a give string is a valid visa card nubmer or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsVisa)]
+    [[play](https://go.dev/play/p/SdS2keOyJsl)]
+-   **<big>IsMasterCard</big>** : check if a give string is a valid master card nubmer or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsMasterCard)]
+    [[play](https://go.dev/play/p/CwWBFRrG27b)]
+-   **<big>IsAmericanExpress</big>** : check if a give string is a valid american expression card nubmer or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsAmericanExpress)]
+    [[play](https://go.dev/play/p/HIDFpcOdpkd)]
+-   **<big>IsUnionPay</big>** : check if a give string is a valid union pay nubmer or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsUnionPay)]
+    [[play](https://go.dev/play/p/CUHPEwEITDf)]
+-   **<big>IsChinaUnionPay</big>** : check if a give string is a valid china union pay nubmer or not.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsChinaUnionPay)]
+    [[play](https://go.dev/play/p/yafpdxLiymu)]

 <h3 id="xerror"> 25. Xerror package implements helpers for errors. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>

--- a/README_zh-CN.md
+++ b/README_zh-CN.md
@@ -18,7 +18,7 @@
    lancet（柳叶刀）是一个全面、高效、可复用的go语言工具函数库。 lancet受到了java apache common包和lodash.js的启发。
 </p>

-## <a href="https://www.golancet.cn/" target="_blank">官网</a> | [English](./README.md) 
+## <a href="https://www.golancet.cn/" target="_blank">官网</a> | [English](./README.md)

 ## 特性

@@ -1329,6 +1329,9 @@ import "github.com/duke-git/lancet/v2/slice"
 -   **<big>Join</big>** : 用指定的分隔符链接切片元素。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#Join)]
    [[play](https://go.dev/play/p/huKzqwNDD7V)]
+-   **<big>Partition</big>** : 根据给定的predicate判断函数分组切片元素。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/slice.md#Partition)]
+    [[play](https://go.dev/play/p/lkQ3Ri2NQhV)]

 <h3 id="stream"> 19. stream 流，该包仅验证简单的 stream 实现，功能有限。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

@@ -1572,7 +1575,6 @@ import "github.com/duke-git/lancet/v2/strutil"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/strutil.md#RemoveWhiteSpace)]
    [[play](https://go.dev/play/p/HzLC9vsTwkf)]

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

 ```go
@@ -1833,6 +1835,33 @@ import "github.com/duke-git/lancet/v2/validator"
 -   **<big>IsPrintable</big>** : 检查字符串是否全部为可打印字符。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsPrintable)]
    [[play](https://go.dev/play/p/Pe1FE2gdtTP)]
+-   **<big>IsBin</big>** : 检查字符串是否是有效的二进制数。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsBin)]
+    [[play](https://go.dev/play/p/ogPeg2XJH4P)]
+-   **<big>IsHex</big>** : 检查字符串是否是有效的十六进制数。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsHex)]
+    [[play](https://go.dev/play/p/M2qpHbEwmm7)]
+-   **<big>IsBase64URL</big>** : 检查字符串是否是有效的 base64 url。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsBase64URL)]
+    [[play](https://go.dev/play/p/vhl4mr8GZ6S)]
+-   **<big>IsJWT</big>** : 检查字符串是否是有效的 JSON Web Token (JWT)。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/validator.md#IsJWT)]
+    [[play](https://go.dev/play/p/R6Op7heJbKI)]
+-   **<big>IsVisa</big>** : 检查字符串是否是有效的 visa 卡号。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsVisa)]
+    [[play](https://go.dev/play/p/SdS2keOyJsl)]
+-   **<big>IsMasterCard</big>** : 检查字符串是否是有效的 MasterCard 卡号。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsMasterCard)]
+    [[play](https://go.dev/play/p/CwWBFRrG27b)]
+-   **<big>IsAmericanExpress</big>** : 检查字符串是否是有效的 American Express 卡号。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsAmericanExpress)]
+    [[play](https://go.dev/play/p/HIDFpcOdpkd)]
+-   **<big>IsUnionPay</big>** : 检查字符串是否是有效的美国银联卡号。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsUnionPay)]
+    [[play](https://go.dev/play/p/CUHPEwEITDf)]
+-   **<big>IsChinaUnionPay</big>** : 检查字符串是否是有效的中国银联卡号。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/validator.md#IsChinaUnionPay)]
+    [[play](https://go.dev/play/p/yafpdxLiymu)]

 <h3 id="xerror"> 25. xerror 包实现一些错误处理函数。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

@@ -1855,7 +1884,7 @@ import "github.com/duke-git/lancet/v2/xerror"
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/xerror.md#XError_Wrap)]
    [[play](https://go.dev/play/p/RpjJ5u5sc97)]
 -   **<big>XError_Unwrap</big>** : 解构 XEerror 为 error 对象。适配 github.com/pkg/errors。
-    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/xerror.md#XError_Unwrap)]
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/xerror.md#XError_Unwrap)
    [[play](https://go.dev/play/p/VUXJ8BST4c6)]
 -   **<big>XError_With</big>** : 添加与 XError 对象的键和值。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/xerror.md#XError_With)]
@@ -1888,7 +1917,7 @@ import "github.com/duke-git/lancet/v2/xerror"

 ## 赞助

-您好，我是一名软件开发者，从事开发工作 13 年。热爱软件开源。并愿意为此付出精力。是开源项目lancet的作者。Lancet 自两年前开源发布以来，已有超过 1000 个内外部项目使用。lancet一直会对所有用户免费。您的支持是对我继续奋斗的有力鼓励。谢谢! 微信扫描以下二维码或点击以下赞助按钮发起赞助。
+您好，我是一名软件开发者，从事开发工作 13 年。热爱软件开源。并愿意为此付出精力。是开源项目 lancet 的作者。Lancet 自两年前开源发布以来，已有超过 1000 个内外部项目使用。lancet 一直会对所有用户免费。您的支持是对我继续奋斗的有力鼓励。谢谢! 微信扫描以下二维码或点击以下赞助按钮发起赞助。

 <div style="position: relative;display: inline-block;">
    <img src="./docs/public/wechat_pay.png" width="260" height="260"/>
@@ -1898,12 +1927,11 @@ import "github.com/duke-git/lancet/v2/xerror"
 <br/>
 <br/>

-*捐赠的资金将用于后续[lancet](https://www.golancet.cn/)官网的维护和云服务器的费用支付。或者当我写代码困倦时，给我买杯 ☕️。*
-
+_捐赠的资金将用于后续[lancet](https://www.golancet.cn/)官网的维护和云服务器的费用支付。或者当我写代码困倦时，给我买杯 ☕️。_

 ## 贡献者

-感谢所有为lancet贡献过代码的人！
+感谢所有为 lancet 贡献过代码的人！

 <a href="https://github.com/duke-git/lancet/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=duke-git/lancet" />
--- a/docs/api/overview.md
+++ b/docs/api/overview.md
@@ -27,7 +27,7 @@ outline: deep
    display: inline-block;
    vertical-align: middle;
    line-height: 40px;
-    background: #ecefff;
+    background: #10b981;
    border: 1px solid;
    margin-right: 10px;
    margin-bottom: 10px;
--- a/docs/api/packages/slice.md
+++ b/docs/api/packages/slice.md
@@ -2464,7 +2464,7 @@ func main() {
 func Partition[T any](slice []T, predicates ...func(item T) bool) [][]T
 ```

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

 ```go
 import (
--- a/docs/api/packages/validator.md
+++ b/docs/api/packages/validator.md
@@ -67,7 +67,6 @@ import (

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

-
 ## 文档

 ### <span id="ContainChinese">ContainChinese</span>
@@ -80,7 +79,7 @@ import (
 func ContainChinese(s string) bool
 ```

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

 ```go
 import (
@@ -114,7 +113,7 @@ func main() {
 func ContainLetter(str string) bool
 ```

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

 ```go
 import (
@@ -148,7 +147,7 @@ func main() {
 func ContainLower(str string) bool
 ```

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

 ```go
 import (
@@ -182,7 +181,7 @@ func main() {
 func ContainUpper(str string) bool
 ```

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

 ```go
 import (
@@ -216,7 +215,7 @@ func main() {
 func IsAlpha(s string) bool
 ```

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

 ```go
 import (
@@ -250,7 +249,7 @@ func main() {
 func IsAllUpper(str string) bool
 ```

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

 ```go
 import (
@@ -284,7 +283,7 @@ func main() {
 func IsAllLower(str string) bool
 ```

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

 ```go
 import (
@@ -318,7 +317,7 @@ func main() {
 func IsASCII(str string) bool
 ```

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

 ```go
 import (
@@ -358,7 +357,7 @@ func main() {
 func IsBase64(base64 string) bool
 ```

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

 ```go
 import (
@@ -389,7 +388,7 @@ func main() {
 func IsChineseMobile(mobileNum string) bool
 ```

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

 ```go
 import (
@@ -420,7 +419,7 @@ func main() {
 func IsChineseIdNum(id string) bool
 ```

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

 ```go
 import (
@@ -451,7 +450,7 @@ func main() {
 func IsChinesePhone(phone string) bool
 ```

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

 ```go
 import (
@@ -482,7 +481,7 @@ func main() {
 func IsCreditCard(creditCart string) bool
 ```

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

 ```go
 import (
@@ -513,7 +512,7 @@ func main() {
 func IsDns(dns string) bool
 ```

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

 ```go
 import (
@@ -547,7 +546,7 @@ func main() {
 func IsEmail(email string) bool
 ```

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

 ```go
 import (
@@ -578,7 +577,7 @@ func main() {
 func IsEmptyString(s string) bool
 ```

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

 ```go
 import (
@@ -612,7 +611,7 @@ func main() {
 func IsInt(v any) bool
 ```

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

 ```go
 import (
@@ -649,7 +648,7 @@ func main() {
 func IsFloat(v any) bool
 ```

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

 ```go
 import (
@@ -686,7 +685,7 @@ func main() {
 func IsNumber(v any) bool
 ```

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

 ```go
 import (
@@ -713,7 +712,6 @@ func main() {
 }
 ```

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

 <p>验证字符串是否是可以转换为整数。</p>
@@ -724,7 +722,7 @@ func main() {
 func IsIntStr(s string) bool
 ```

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

 ```go
 import (
@@ -761,7 +759,7 @@ func main() {
 func IsFloatStr(s string) bool
 ```

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

 ```go
 import (
@@ -798,7 +796,7 @@ func main() {
 func IsNumberStr(s string) bool
 ```

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

 ```go
 import (
@@ -835,7 +833,7 @@ func main() {
 func IsJSON(str string) bool
 ```

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

 ```go
 import (
@@ -872,7 +870,7 @@ func main() {
 func IsRegexMatch(s, regex string) bool
 ```

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

 ```go
 import (
@@ -893,8 +891,6 @@ func main() {
 }
 ```

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

 <p>验证字符串是否是ip地址。</p>
@@ -905,7 +901,7 @@ func main() {
 func IsIp(ipstr string) bool
 ```

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

 ```go
 import (
@@ -942,7 +938,7 @@ func main() {
 func IsIpV4(ipstr string) bool
 ```

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

 ```go
 import (
@@ -973,7 +969,7 @@ func main() {
 func IsIpV6(ipstr string) bool
 ```

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

 ```go
 import (
@@ -1004,7 +1000,7 @@ func main() {
 func IsStrongPassword(password string, length int) bool
 ```

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

 ```go
 import (
@@ -1035,7 +1031,7 @@ func main() {
 func IsUrl(str string) bool
 ```

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

 ```go
 import (
@@ -1070,7 +1066,7 @@ func main() {
 func IsWeakPassword(password string, length int) bool
 ```

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

 ```go
 import (
@@ -1101,7 +1097,7 @@ func main() {
 func IsZeroValue(value any) bool
 ```

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

 ```go
 import (
@@ -1138,7 +1134,7 @@ func main() {
 func IsGBK(data []byte) bool
 ```

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

 ```go
 import (
@@ -1160,7 +1156,6 @@ func main() {
 }
 ```

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

 <p>检查字符串是否全部为可打印字符。</p>
@@ -1171,7 +1166,7 @@ func main() {
 func IsPrintable(str string) bool
 ```

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

 ```go
 import (
@@ -1211,7 +1206,7 @@ func main() {
 func IsBin(v string) bool
 ```

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

 ```go
 import (
@@ -1248,7 +1243,7 @@ func main() {
 func IsHex(v string) bool
 ```

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

 ```go
 import (
@@ -1285,7 +1280,7 @@ func main() {
 func IsBase64URL(v string) bool
 ```

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

 ```go
 import (
@@ -1322,7 +1317,7 @@ func main() {
 func IsJWT(v string) bool
 ```

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

 ```go
 import (
@@ -1353,7 +1348,7 @@ func main() {
 func IsVisa(v string) bool
 ```

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

 ```go
 import (
@@ -1384,7 +1379,7 @@ func main() {
 func IsMasterCard(v string) bool
 ```

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

 ```go
 import (
@@ -1415,7 +1410,7 @@ func main() {
 func IsAmericanExpress(v string) bool
 ```

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

 ```go
 import (
@@ -1436,7 +1431,7 @@ func main() {
 }
 ```

-### <span id="IsUnionPay">IsVisa</span>
+### <span id="IsUnionPay">IsUnionPay</span>

 <p>检查字符串是否是有效的美国银联卡号。</p>

@@ -1446,7 +1441,7 @@ func main() {
 func IsUnionPay(v string) bool
 ```

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

 ```go
 import (
@@ -1477,7 +1472,7 @@ func main() {
 func IsChinaUnionPay(v string) bool
 ```

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

 ```go
 import (
--- a/docs/en/api/overview.md
+++ b/docs/en/api/overview.md
@@ -27,7 +27,7 @@ outline: deep
    display: inline-block;
    vertical-align: middle;
    line-height: 40px;
-    background: #ecefff;
+    background: #059669;
    border: 1px solid;
    margin-right: 10px;
    margin-bottom: 10px;
--- a/docs/en/api/packages/slice.md
+++ b/docs/en/api/packages/slice.md
@@ -91,6 +91,7 @@ import (
 -   [Without](#Without)
 -   [KeyBy](#KeyBy)
 -   [Join](#Join)
+-   [Partition](#Partition)

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

@@ -2461,7 +2462,7 @@ func main() {
 func Partition[T any](slice []T, predicates ...func(item T) bool) [][]T
 ```

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

 ```go
 import (
--- a/docs/en/api/packages/validator.md
+++ b/docs/en/api/packages/validator.md
@@ -81,7 +81,7 @@ import (
 func ContainChinese(s string) bool
 ```

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

 ```go
 import (
@@ -115,7 +115,7 @@ func main() {
 func ContainLetter(str string) bool
 ```

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

 ```go
 import (
@@ -149,7 +149,7 @@ func main() {
 func ContainLower(str string) bool
 ```

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

 ```go
 import (
@@ -183,7 +183,7 @@ func main() {
 func ContainUpper(str string) bool
 ```

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

 ```go
 import (
@@ -217,7 +217,7 @@ func main() {
 func IsAlpha(s string) bool
 ```

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

 ```go
 import (
@@ -251,7 +251,7 @@ func main() {
 func IsAllUpper(str string) bool
 ```

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

 ```go
 import (
@@ -285,7 +285,7 @@ func main() {
 func IsAllLower(str string) bool
 ```

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

 ```go
 import (
@@ -319,7 +319,7 @@ func main() {
 func IsASCII(str string) bool
 ```

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

 ```go
 import (
@@ -359,7 +359,7 @@ func main() {
 func IsBase64(base64 string) bool
 ```

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

 ```go
 import (
@@ -390,7 +390,7 @@ func main() {
 func IsChineseMobile(mobileNum string) bool
 ```

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

 ```go
 import (
@@ -421,7 +421,7 @@ func main() {
 func IsChineseIdNum(id string) bool
 ```

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

 ```go
 import (
@@ -452,7 +452,7 @@ func main() {
 func IsChinesePhone(phone string) bool
 ```

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

 ```go
 import (
@@ -483,7 +483,7 @@ func main() {
 func IsCreditCard(creditCart string) bool
 ```

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

 ```go
 import (
@@ -514,7 +514,7 @@ func main() {
 func IsDns(dns string) bool
 ```

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

 ```go
 import (
@@ -548,7 +548,7 @@ func main() {
 func IsEmail(email string) bool
 ```

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

 ```go
 import (
@@ -579,7 +579,7 @@ func main() {
 func IsEmptyString(s string) bool
 ```

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

 ```go
 import (
@@ -613,7 +613,7 @@ func main() {
 func IsInt(v any) bool
 ```

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

 ```go
 import (
@@ -650,7 +650,7 @@ func main() {
 func IsFloat(v any) bool
 ```

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

 ```go
 import (
@@ -687,7 +687,7 @@ func main() {
 func IsNumber(v any) bool
 ```

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

 ```go
 import (
@@ -724,7 +724,7 @@ func main() {
 func IsIntStr(s string) bool
 ```

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

 ```go
 import (
@@ -761,7 +761,7 @@ func main() {
 func IsFloatStr(s string) bool
 ```

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

 ```go
 import (
@@ -798,7 +798,7 @@ func main() {
 func IsNumberStr(s string) bool
 ```

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

 ```go
 import (
@@ -835,7 +835,7 @@ func main() {
 func IsJSON(str string) bool
 ```

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

 ```go
 import (
@@ -872,7 +872,7 @@ func main() {
 func IsRegexMatch(s, regex string) bool
 ```

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

 ```go
 import (
@@ -903,7 +903,7 @@ func main() {
 func IsIp(ipstr string) bool
 ```

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

 ```go
 import (
@@ -940,7 +940,7 @@ func main() {
 func IsIpV4(ipstr string) bool
 ```

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

 ```go
 import (
@@ -971,7 +971,7 @@ func main() {
 func IsIpV6(ipstr string) bool
 ```

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

 ```go
 import (
@@ -1002,7 +1002,7 @@ func main() {
 func IsStrongPassword(password string, length int) bool
 ```

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

 ```go
 import (
@@ -1033,7 +1033,7 @@ func main() {
 func IsUrl(str string) bool
 ```

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

 ```go
 import (
@@ -1068,7 +1068,7 @@ func main() {
 func IsWeakPassword(password string, length int) bool
 ```

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

 ```go
 import (
@@ -1099,7 +1099,7 @@ func main() {
 func IsZeroValue(value any) bool
 ```

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

 ```go
 import (
@@ -1136,7 +1136,7 @@ func main() {
 func IsGBK(data []byte) bool
 ```

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

 ```go
 import (
@@ -1168,7 +1168,7 @@ func main() {
 func IsPrintable(str string) bool
 ```

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

 ```go
 import (
@@ -1208,7 +1208,7 @@ func main() {
 func IsBin(v string) bool
 ```

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

 ```go
 import (
@@ -1245,7 +1245,7 @@ func main() {
 func IsHex(v string) bool
 ```

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

 ```go
 import (
@@ -1282,7 +1282,7 @@ func main() {
 func IsBase64URL(v string) bool
 ```

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

 ```go
 import (
@@ -1319,7 +1319,7 @@ func main() {
 func IsJWT(v string) bool
 ```

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

 ```go
 import (
@@ -1350,7 +1350,7 @@ func main() {
 func IsVisa(v string) bool
 ```

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

 ```go
 import (
@@ -1381,7 +1381,7 @@ func main() {
 func IsMasterCard(v string) bool
 ```

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

 ```go
 import (
@@ -1412,7 +1412,7 @@ func main() {
 func IsAmericanExpress(v string) bool
 ```

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

 ```go
 import (
@@ -1443,7 +1443,7 @@ func main() {
 func IsUnionPay(v string) bool
 ```

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

 ```go
 import (
@@ -1474,7 +1474,7 @@ func main() {
 func IsChinaUnionPay(v string) bool
 ```

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

 ```go
 import (
--- a/slice/slice.go
+++ b/slice/slice.go
@@ -1201,7 +1201,7 @@ func Join[T any](slice []T, separator string) string {
 }

 // Partition all slice elements with the evaluation of the given predicate functions.
-// todo
+// Play: https://go.dev/play/p/lkQ3Ri2NQhV
 func Partition[T any](slice []T, predicates ...func(item T) bool) [][]T {
 	l := len(predicates)

--- a/validator/validator.go
+++ b/validator/validator.go
@@ -411,25 +411,25 @@ func IsInt(v any) bool {
 }

 // IsBin check if a give string is a valid binary value or not.
-// Play: todo
+// Play: https://go.dev/play/p/ogPeg2XJH4P
 func IsBin(v string) bool {
 	return binMatcher.MatchString(v)
 }

 // IsHex check if a give string is a valid hexadecimal value or not.
-// Play: todo
+// Play: https://go.dev/play/p/M2qpHbEwmm7
 func IsHex(v string) bool {
 	return hexMatcher.MatchString(v)
 }

 // IsBase64URL check if a give string is a valid URL-safe Base64 encoded string.
-// Play: todo
+// Play: https://go.dev/play/p/vhl4mr8GZ6S
 func IsBase64URL(v string) bool {
 	return base64URLMatcher.MatchString(v)
 }

-// IsJWT check if a give string is is a valid JSON Web Token (JWT).
-// Play: todo
+// IsJWT check if a give string is a valid JSON Web Token (JWT).
+// Play: https://go.dev/play/p/R6Op7heJbKI
 func IsJWT(v string) bool {
 	strings := strings.Split(v, ".")
 	if len(strings) != 3 {
@@ -446,31 +446,31 @@ func IsJWT(v string) bool {
 }

 // IsVisa check if a give string is a valid visa card nubmer or not.
-// Play: todo
+// Play: https://go.dev/play/p/SdS2keOyJsl
 func IsVisa(v string) bool {
 	return visaMatcher.MatchString(v)
 }

 // IsMasterCard check if a give string is a valid master card nubmer or not.
-// Play: todo
+// Play: https://go.dev/play/p/CwWBFRrG27b
 func IsMasterCard(v string) bool {
 	return masterCardMatcher.MatchString(v)
 }

 // IsAmericanExpress check if a give string is a valid american expression card nubmer or not.
-// Play: todo
+// Play: https://go.dev/play/p/HIDFpcOdpkd
 func IsAmericanExpress(v string) bool {
 	return americanExpressMatcher.MatchString(v)
 }

 // IsUnionPay check if a give string is a valid union pay nubmer or not.
-// Play: todo
+// Play: https://go.dev/play/p/CUHPEwEITDf
 func IsUnionPay(v string) bool {
 	return unionPay.MatchString(v)
 }

 // IsChinaUnionPay check if a give string is a valid china union pay nubmer or not.
-// Play: todo
+// Play: https://go.dev/play/p/yafpdxLiymu
 func IsChinaUnionPay(v string) bool {
 	return chinaUnionPay.MatchString(v)
 }