doc: normalize documents

2026-02-12 16:52:29 +08:00 · 2023-01-13 14:36:33 +08:00
parent 2c6e9a3fb9
commit 4c5524354c
12 changed files with 1800 additions and 1211 deletions
--- a/docs/maputil_zh-CN.md
+++ b/docs/maputil_zh-CN.md
@@ -1,16 +1,17 @@
 # Maputil
-maputil包包括一些操作map的函数。
+
+maputil 包包括一些操作 map 的函数。

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

 ## 源码:

- [https://github.com/duke-git/lancet/blob/main/maputil/map.go](https://github.com/duke-git/lancet/blob/main/maputil/map.go)
-
+-   [https://github.com/duke-git/lancet/blob/main/maputil/map.go](https://github.com/duke-git/lancet/blob/main/maputil/map.go)

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

 ## 用法:
+
 ```go
 import (
    "github.com/duke-git/lancet/v2/maputil"
@@ -20,22 +21,22 @@ import (
 <div STYLE="page-break-after: always;"></div>

 ## 目录:
- [ForEach](#ForEach)
- [Filter](#Filter)
- [Intersect](#Intersect)
- [Keys](#Keys)
- [Merge](#Merge)
- [Minus](#Minus)
- [Values](#Values)
- [IsDisjoint](#IsDisjoint)
+
+-   [ForEach](#ForEach)
+-   [Filter](#Filter)
+-   [Intersect](#Intersect)
+-   [Keys](#Keys)
+-   [Merge](#Merge)
+-   [Minus](#Minus)
+-   [Values](#Values)
+-   [IsDisjoint](#IsDisjoint)

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

-## API文档:
-
-
+## API 文档:

 ### <span id="ForEach">ForEach</span>
+
 <p>对map中的每对key和value执行iteratee函数</p>

 <b>函数签名:</b>
@@ -43,6 +44,7 @@ import (
 ```go
 func ForEach[K comparable, V any](m map[K]V, iteratee func(key K, value V))
 ```
+
 <b>例子:</b>

 ```go
@@ -54,26 +56,28 @@ import (
 )

 func main() {
-	m := map[string]int{
-		"a": 1,
-		"b": 2,
-		"c": 3,
-		"d": 4,
-	}
+    m := map[string]int{
+        "a": 1,
+        "b": 2,
+        "c": 3,
+        "d": 4,
+    }

-	var sum int
+    var sum int

-	maputil.ForEach(m, func(_ string, value int) {
-		sum += value
-	})
-	fmt.Println(sum) // 10
+    maputil.ForEach(m, func(_ string, value int) {
+        sum += value
+    })
+    
+    fmt.Println(sum)
+
+    // Output:
+    // 10
 }
 ```

-
-
-
 ### <span id="Filter">Filter</span>
+
 <p>迭代map中的每对key和value, 返回符合predicate函数的key, value</p>

 <b>函数签名:</b>
@@ -81,6 +85,7 @@ func main() {
 ```go
 func Filter[K comparable, V any](m map[K]V, predicate func(key K, value V) bool) map[K]V
 ```
+
 <b>例子:</b>

 ```go
@@ -92,29 +97,32 @@ import (
 )

 func main() {
-	m := map[string]int{
-		"a": 1,
-		"b": 2,
-		"c": 3,
-		"d": 4,
-		"e": 5,
-	}
-	isEven := func(_ string, value int) bool {
-		return value%2 == 0
-	}
+    m := map[string]int{
+        "a": 1,
+        "b": 2,
+        "c": 3,
+        "d": 4,
+        "e": 5,
+    }
+    isEven := func(_ string, value int) bool {
+        return value%2 == 0
+    }

-	maputil.Filter(m, func(_ string, value int) {
-		sum += value
-	})
-	res := maputil.Filter(m, isEven)
-	fmt.Println(res) // map[string]int{"b": 2, "d": 4,}
+    maputil.Filter(m, func(_ string, value int) {
+        sum += value
+    })
+    
+    result := Filter(m, isEven)
+
+    fmt.Println(result)
+
+    // Output:
+    // map[b:2 d:4]
 }
 ```

-
-
-
 ### <span id="Intersect">Intersect</span>
+
 <p>多个map的交集操作</p>

 <b>函数签名:</b>
@@ -122,6 +130,7 @@ func main() {
 ```go
 func Intersect[K comparable, V any](maps ...map[K]V) map[K]V
 ```
+
 <b>例子:</b>

 ```go
@@ -133,37 +142,42 @@ import (
 )

 func main() {
-	m1 := map[string]int{
-		"a": 1,
-		"b": 2,
-		"c": 3,
-	}
+    m1 := map[string]int{
+        "a": 1,
+        "b": 2,
+        "c": 3,
+    }

-	m2 := map[string]int{
-		"a": 1,
-		"b": 2,
-		"c": 6,
-		"d": 7,
-	}
+    m2 := map[string]int{
+        "a": 1,
+        "b": 2,
+        "c": 6,
+        "d": 7,
+    }

-	m3 := map[string]int{
-		"a": 1,
-		"b": 9,
-		"e": 9,
-	}
+    m3 := map[string]int{
+        "a": 1,
+        "b": 9,
+        "e": 9,
+    }

-	fmt.Println(maputil.Intersect(m1)) // map[string]int{"a": 1, "b": 2, "c": 3}
+    result1 := maputil.Intersect(m1)
+    result2 := maputil.Intersect(m1, m2)
+    result3 := maputil.Intersect(m1, m2, m3)

-	fmt.Println(maputil.Intersect(m1, m2)) // map[string]int{"a": 1, "b": 2}
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)

-	fmt.Println(maputil.Intersect(m1, m2, m3)) // map[string]int{"a": 1}
+    // Output:
+    // map[a:1 b:2 c:3]
+    // map[a:1 b:2]
+    // map[a:1]
 }
 ```

-
-
-
 ### <span id="Keys">Keys</span>
+
 <p>返回map中所有key的切片</p>

 <b>函数签名:</b>
@@ -171,6 +185,7 @@ func main() {
 ```go
 func Keys[K comparable, V any](m map[K]V) []K
 ```
+
 <b>例子:</b>

 ```go
@@ -182,24 +197,26 @@ import (
 )

 func main() {
-	m := map[int]string{
-		1: "a",
-		2: "a",
-		3: "b",
-		4: "c",
-		5: "d",
-	}
+    m := map[int]string{
+        1: "a",
+        2: "a",
+        3: "b",
+        4: "c",
+        5: "d",
+    }

-	keys := maputil.Keys(m)
-	sort.Ints(keys)
-	fmt.Println(keys) // []int{1, 2, 3, 4, 5}
+    keys := maputil.Keys(m)
+    sort.Ints(keys)
+    
+    fmt.Println(keys)
+
+    // Output:
+    // [1 2 3 4 5]
 }
 ```

-
-
-
 ### <span id="Merge">Merge</span>
+
 <p>合并多个maps, 相同的key会被后来的key覆盖</p>

 <b>函数签名:</b>
@@ -207,6 +224,7 @@ func main() {
 ```go
 func Merge[K comparable, V any](maps ...map[K]V) map[K]V
 ```
+
 <b>例子:</b>

 ```go
@@ -218,21 +236,26 @@ import (
 )

 func main() {
-	m1 := map[int]string{
-		1: "a",
-		2: "b",
-	}
-	m2 := map[int]string{
-		1: "1",
-		3: "2",
-	}
-	fmt.Println(maputil.Merge(m1, m2)) // map[int]string{1:"1", 2:"b", 3:"2",}
+    m1 := map[int]string{
+        1: "a",
+        2: "b",
+    }
+    m2 := map[int]string{
+        1: "1",
+        3: "2",
+    }
+    
+    result := maputil.Merge(m1, m2)
+
+    fmt.Println(result)
+
+    // Output:
+    // map[1:c 2:b 3:d]
 }
 ```

-
-
 ### <span id="Minus">Minus</span>
+
 <p>返回一个map，其中的key存在于mapA，不存在于mapB.</p>

 <b>函数签名:</b>
@@ -240,6 +263,7 @@ func main() {
 ```go
 func Minus[K comparable, V any](mapA, mapB map[K]V) map[K]V
 ```
+
 <b>例子:</b>

 ```go
@@ -251,25 +275,29 @@ import (
 )

 func main() {
-	m1 := map[string]int{
-		"a": 1,
-		"b": 2,
-		"c": 3,
-	}
+    m1 := map[string]int{
+        "a": 1,
+        "b": 2,
+        "c": 3,
+    }

-	m2 := map[string]int{
-		"a": 11,
-		"b": 22,
-		"d": 33,
-	}
+    m2 := map[string]int{
+        "a": 11,
+        "b": 22,
+        "d": 33,
+    }

-	fmt.Println(maputil.Minus(m1, m2)) //map[string]int{"c": 3}
+    result := maputil.Minus(m1, m2)
+
+    fmt.Println(result)
+
+    // Output:
+    // map[c:3]
 }
 ```

-
-
 ### <span id="Values">Values</span>
+
 <p>返回map中所有value的切片</p>

 <b>函数签名:</b>
@@ -277,6 +305,7 @@ func main() {
 ```go
 func Values[K comparable, V any](m map[K]V) []V
 ```
+
 <b>例子:</b>

 ```go
@@ -288,23 +317,24 @@ import (
 )

 func main() {
-	m := map[int]string{
-		1: "a",
-		2: "a",
-		3: "b",
-		4: "c",
-		5: "d",
-	}
+    m := map[int]string{
+        1: "a",
+        2: "a",
+        3: "b",
+        4: "c",
+        5: "d",
+    }

-	values := maputil.Values(m)
-	sort.Strings(values)
+    values := maputil.Values(m)
+    sort.Strings(values)

-	fmt.Println(values) // []string{"a", "a", "b", "c", "d"}
+    // Output:
+    // [a a b c d]
 }
 ```

-
 ### <span id="IsDisjoint">IsDisjoint</span>
+
 <p>验证两个map是否具有不同的key</p>

 <b>函数签名:</b>
@@ -312,6 +342,7 @@ func main() {
 ```go
 func IsDisjoint[K comparable, V any](mapA, mapB map[K]V) bool
 ```
+
 <b>例子:</b>

 ```go
@@ -323,30 +354,28 @@ import (
 )

 func main() {
-	m1 := map[int]string{
-		1: "a",
-		2: "a",
-		3: "b",
-		4: "c",
-		5: "d",
-	}
+    m1 := map[string]int{
+        "a": 1,
+        "b": 2,
+        "c": 3,
+    }

-	m2 := map[int]string{
-		1: "a",
-		2: "a",
-		3: "b",
-		4: "c",
-		5: "d",
-	}
+    m2 := map[string]int{
+        "d": 22,
+    }

-	m3 := map[int]string{
-		6: "a",
-	}
+    m3 := map[string]int{
+        "a": 22,
+    }

-	ok := maputil.IsDisjoint(m2, m1)
-	fmt.Println(ok) // false
+    result1 := maputil.IsDisjoint(m1, m2)
+    result2 := maputil.IsDisjoint(m1, m3)

-	ok = maputil.IsDisjoint(m2, m3)
-	fmt.Println(ok) // true
+    fmt.Println(result1)
+    fmt.Println(result2)
+
+    // Output:
+    // true
+    // false
 }
-```
+```