doc: fmt code example

README.md

@@ -219,6 +219,7 @@ import queue "github.com/duke-git/lancet/v2/datastructure/queue"
 import set "github.com/duke-git/lancet/v2/datastructure/set"
 import tree "github.com/duke-git/lancet/v2/datastructure/tree"
 import heap "github.com/duke-git/lancet/v2/datastructure/heap"
+import hashmap "github.com/duke-git/lancet/v2/datastructure/hashmap"
 ```
 #### Function list:
 - [List](https://github.com/duke-git/lancet/blob/main/docs/datastructure/list.md)
@@ -228,6 +229,7 @@ import heap "github.com/duke-git/lancet/v2/datastructure/heap"
 - [Set](https://github.com/duke-git/lancet/blob/main/docs/datastructure/set.md)
 - [Tree](https://github.com/duke-git/lancet/blob/main/docs/datastructure/tree.md)
 - [Heap](https://github.com/duke-git/lancet/blob/main/docs/datastructure/heap.md)
+- [HashMap](https://github.com/duke-git/lancet/blob/main/docs/datastructure/hashmap.md)
 
 
 ### 7. Fileutil package implements some basic functions for file operations.

README_zh-CN.md

@@ -216,6 +216,7 @@ import queue "github.com/duke-git/lancet/v2/datastructure/queue"
 import set "github.com/duke-git/lancet/v2/datastructure/set"
 import tree "github.com/duke-git/lancet/v2/datastructure/tree"
 import heap "github.com/duke-git/lancet/v2/datastructure/heap"
+import hashmap "github.com/duke-git/lancet/v2/datastructure/hashmap"
 ```
 #### Function list:
 - [List](https://github.com/duke-git/lancet/blob/main/docs/datastructure/list_zh-CN.md)
@@ -225,6 +226,7 @@ import heap "github.com/duke-git/lancet/v2/datastructure/heap"
 - [Set](https://github.com/duke-git/lancet/blob/main/docs/datastructure/set_zh-CN.md)
 - [Tree](https://github.com/duke-git/lancet/blob/main/docs/datastructure/tree_zh-CN.md)
 - [Heap](https://github.com/duke-git/lancet/blob/main/docs/datastructure/heap.md)
+- [HashMap](https://github.com/duke-git/lancet/blob/main/docs/datastructure/hashmap.md)
 
 
 ### 7. fileutil包支持文件基本操作。

convertor/convertor.go

@@ -7,6 +7,7 @@ package convertor
 import (
 	"bytes"
 	"encoding/binary"
+	"encoding/gob"
 	"encoding/json"
 	"fmt"
 	"math"
@@ -270,3 +271,21 @@ func ColorRGBToHex(red, green, blue int) string {
 
 	return "#" + r + g + b
 }
+
+// EncodeByte encode data to byte
+func EncodeByte(data any) ([]byte, error) {
+	buffer := bytes.NewBuffer(nil)
+	encoder := gob.NewEncoder(buffer)
+	err := encoder.Encode(data)
+	if err != nil {
+		return nil, err
+	}
+	return buffer.Bytes(), nil
+}
+
+// DecodeByte decode byte data to target object
+func DecodeByte(data []byte, target any) error {
+	buffer := bytes.NewBuffer(data)
+	decoder := gob.NewDecoder(buffer)
+	return decoder.Decode(target)
+}

convertor/convertor_test.go

@@ -238,3 +238,21 @@ func TestToPointer(t *testing.T) {
 
 	assert.Equal(*result, 123)
 }
+
+func TestEncodeByte(t *testing.T) {
+	assert := internal.NewAssert(t, "TestEncodeByte")
+
+	byteData, _ := EncodeByte("abc")
+	expected := []byte{6, 12, 0, 3, 97, 98, 99}
+
+	assert.Equal(expected, byteData)
+}
+
+func TestDecodeByte(t *testing.T) {
+	assert := internal.NewAssert(t, "TestDecodeByte")
+
+	var obj string
+	byteData := []byte{6, 12, 0, 3, 97, 98, 99}
+	DecodeByte(byteData, &obj)
+	assert.Equal("abc", obj)
+}

docs/convertor.md

@@ -34,6 +34,8 @@ import (
 - [ToString](#ToString)
 - [StructToMap](#StructToMap)
 - [MapToSlice](#MapToSlice)
+- [EncodeByte](#EncodeByte)
+- [DecodeByte](#DecodeByte)
 
 <div STYLE="page-break-after: always;"></div>
 
@@ -457,4 +459,59 @@ func main() {
 
     fmt.Println(result) //[]string{"a:1", "b:2", "c:3"}
 }
+```
+
+
+### <span id="EncodeByte">EncodeByte</span>
+
+<p>Encode data to byte slice.</p>
+
+<b>Signature:</b>
+
+```go
+func EncodeByte(data any) ([]byte, error)
+```
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/convertor"
+)
+
+func main() {
+    byteData, _ := convertor.EncodeByte("abc")
+    fmt.Println(byteData) //[]byte{6, 12, 0, 3, 97, 98, 99}
+}
+```
+
+
+
+### <span id="DecodeByte">DecodeByte</span>
+
+<p>Decode byte data to target object. target should be a pointer instance.</p>
+
+<b>Signature:</b>
+
+```go
+func DecodeByte(data []byte, target any) error
+```
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/convertor"
+)
+
+func main() {
+    var result string
+	byteData := []byte{6, 12, 0, 3, 97, 98, 99}
+	convertor.DecodeByte(byteData, &result)
+    fmt.Println(result) //"abc"
+}
 ```

docs/convertor_zh-CN.md

@@ -36,6 +36,8 @@ import (
 - [ToString](#ToString)
 - [StructToMap](#StructToMap)
 - [MapToSlice](#MapToSlice)
+- [EncodeByte](#EncodeByte)
+- [DecodeByte](#DecodeByte)
 
 <div STYLE="page-break-after: always;"></div>
 
@@ -489,3 +491,59 @@ func main() {
     fmt.Println(result) //[]string{"a:1", "b:2", "c:3"}
 }
 ```
+
+
+
+### <span id="EncodeByte">EncodeByte</span>
+
+<p>将data编码成字节切片</p>
+
+<b>函数签名:</b>
+
+```go
+func EncodeByte(data any) ([]byte, error)
+```
+<b>例子:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/convertor"
+)
+
+func main() {
+    byteData, _ := convertor.EncodeByte("abc")
+    fmt.Println(byteData) //[]byte{6, 12, 0, 3, 97, 98, 99}
+}
+```
+
+
+
+### <span id="DecodeByte">DecodeByte</span>
+
+<p>解码字节切片到目标对象，目标对象需要传入一个指针实例子</p>
+
+<b>函数签名:</b>
+
+```go
+func DecodeByte(data []byte, target any) error
+```
+<b>例子:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/convertor"
+)
+
+func main() {
+    var result string
+	byteData := []byte{6, 12, 0, 3, 97, 98, 99}
+	convertor.DecodeByte(byteData, &result)
+    fmt.Println(result) //"abc"
+}
+```

docs/datastructure/hashmap.md

@@ -20,6 +20,7 @@ import (
 
 <div STYLE="page-break-after: always;"></div>
 
+
 ## Index
 
 - [NewHashMap](#NewHashMap)
@@ -106,8 +107,8 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	val := hm.Get("a")
+    hm := heap.NewHashMap()
+    val := hm.Get("a")
 
     fmt.Println(val) //nil
 }
@@ -134,10 +135,10 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	hm.Put("a", 1)
+    hm := heap.NewHashMap()
+    hm.Put("a", 1)
 
-	val := hm.Get("a")
+    val := hm.Get("a")
     fmt.Println(val) //1
 }
 ```
@@ -165,13 +166,13 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	hm.Put("a", 1)
-	val := hm.Get("a")
+    hm := heap.NewHashMap()
+    hm.Put("a", 1)
+    val := hm.Get("a")
     fmt.Println(val) //1
 
-	hm.Delete("a")
-	val = hm.Get("a")
+    hm.Delete("a")
+    val = hm.Get("a")
     fmt.Println(val) //nil
 }
 ```
@@ -199,8 +200,8 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	hm.Put("a", 1)
+    hm := heap.NewHashMap()
+    hm.Put("a", 1)
 
     fmt.Println(hm.Contains("a")) //true
     fmt.Println(hm.Contains("b")) //false

docs/datastructure/hashmap_zh-CN.md

@@ -22,17 +22,13 @@ import (
 
 ## 目录
 
-- [HashMap](#hashmap)
-  - [源码](#源码)
-  - [用法](#用法)
-  - [目录](#目录)
-  - [API 文档](#api-文档)
-    - [<span id="NewHashMap">NewHashMap</span>](#newhashmap)
-    - [<span id="NewHashMapWithCapacity">NewHashMapWithCapacity</span>](#newhashmapwithcapacity)
-    - [<span id="Get">Get</span>](#get)
-    - [<span id="Put">Put</span>](#put)
-    - [<span id="Delete">Delete</span>](#delete)
-    - [<span id="Contains">Contains</span>](#contains)
+- [NewHashMap](#NewHashMap)
+- [NewHashMapWithCapacity](#NewHashMapWithCapacity)
+
+- [Get](#Get)
+- [Put](#Put)
+- [Delete](#Delete)
+- [Contains](#Contains)
 
 <div STYLE="page-break-after: always;"></div>
 
@@ -111,8 +107,8 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	val := hm.Get("a")
+    hm := heap.NewHashMap()
+    val := hm.Get("a")
 
     fmt.Println(val) //nil
 }
@@ -139,10 +135,10 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	hm.Put("a", 1)
+    hm := heap.NewHashMap()
+    hm.Put("a", 1)
 
-	val := hm.Get("a")
+    val := hm.Get("a")
     fmt.Println(val) //1
 }
 ```
@@ -168,13 +164,13 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	hm.Put("a", 1)
-	val := hm.Get("a")
+    hm := heap.NewHashMap()
+    hm.Put("a", 1)
+    val := hm.Get("a")
     fmt.Println(val) //1
 
-	hm.Delete("a")
-	val = hm.Get("a")
+    hm.Delete("a")
+    val = hm.Get("a")
     fmt.Println(val) //nil
 }
 ```
@@ -200,8 +196,8 @@ import (
 )
 
 func main() {
-	hm := heap.NewHashMap()
-	hm.Put("a", 1)
+    hm := heap.NewHashMap()
+    hm.Put("a", 1)
 
     fmt.Println(hm.Contains("a")) //true
     fmt.Println(hm.Contains("b")) //false

docs/xerror.md

@@ -46,7 +46,7 @@ import (
 )
 
 func main() {
-    _, err := strconv.Atoi("4o2")
+	_, err := strconv.Atoi("4o2")
 	defer func() {
 		v := recover()
 		fmt.Println(err.Error()) // err.Error() == v.(*strconv.NumError).Error()

docs/xerror_zh-CN.md

@@ -46,7 +46,7 @@ import (
 )
 
 func main() {
-    _, err := strconv.Atoi("4o2")
+	_, err := strconv.Atoi("4o2")
 	defer func() {
 		v := recover()
 		fmt.Println(err.Error()) // err.Error() == v.(*strconv.NumError).Error()