doc: update doc for mathutil package

feat(mathutil): add DIv, FloorToFloat, FloorToString, CeilToFloat, CeilToString (#199 )
doc: update doc for new added functions
2026-03-01 00:35:28 +08:00 · 2024-03-04 19:52:49 +08:00 · 2024-03-04 17:40:31 +08:00 · 2024-03-04 16:42:59 +08:00 · 2024-03-04 16:41:54 +08:00
11 changed files with 847 additions and 282 deletions
@@ -953,6 +953,14 @@ import "github.com/duke-git/lancet/v2/mathutil"
 -   **<big>TruncRound</big>** : round off n decimal places for int64.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#TruncRound)]
    [[play](https://go.dev/play/p/aumarSHIGzP)]
+-   **<big>CeilToFloat</big>** : round float up n decimal places.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#CeilToFloat)]
+-   **<big>CeilToString</big>** : round float up n decimal places, then conver to string.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#CeilToString)]
+-   **<big>FloorToFloat</big>** : round float down n decimal places.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#FloorToFloat)]
+-   **<big>FloorToString</big>** : round float down n decimal places, then conver to string.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#FloorToString)]
 -   **<big>Range</big>** : Creates a slice of numbers from start with specified count, element step is 1.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#Range)]
    [[play](https://go.dev/play/p/9ke2opxa8ZP)]
@@ -992,6 +1000,9 @@ import "github.com/duke-git/lancet/v2/mathutil"
 -   **<big>Abs</big>** : returns the absolute value of param number.
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#Sum)]
    [[play](https://go.dev/play/p/fsyBh1Os-1d)]
+-   **<big>Div</big>** : returns the result of x divided by y.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/en/api/packages/mathutil.md#Div)]
+

 <h3 id="netutil"> 14. Netutil package contains functions to get net information and send http request. &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">index</a></h3>

@@ -100,6 +100,7 @@ func main() {
 -   [Validator](#user-content-validator)
 -   [Xerror](#user-content-xerror)

+
 <h3 id="algorithm"> 1. algorithm 包实现一些基本查找和排序算法。 &nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

 ```go
@@ -951,6 +952,14 @@ import "github.com/duke-git/lancet/v2/mathutil"
 -   **<big>TruncRound</big>** : 截短 n 位小数（不进行四舍五入）。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#TruncRound)]
    [[play](https://go.dev/play/p/aumarSHIGzP)]
+-   **<big>CeilToFloat</big>** : 向上舍入（进一法），保留n位小数。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#CeilToFloat)]
+-   **<big>CeilToString</big>** : 向上舍入（进一法），保留n位小数，返回字符串。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#CeilToString)]
+-   **<big>FloorToFloat</big>** : 向下舍入（去尾法），保留n位小数。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#FloorToFloat)]
+-   **<big>FloorToString</big>** : 向下舍入（去尾法），保留n位小数，返回字符串。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#FloorToString)]
 -   **<big>Range</big>** : 根据指定的起始值和数量，创建一个数字切片。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#Range)]
    [[play](https://go.dev/play/p/9ke2opxa8ZP)]
@@ -990,6 +999,10 @@ import "github.com/duke-git/lancet/v2/mathutil"
 -   **<big>Abs</big>** : 求绝对值。
    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#Sum)]
    [[play](https://go.dev/play/p/fsyBh1Os-1d)]
+-   **<big>Div</big>** : 除法运算。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/api/packages/mathutil.md#Div)]
+
+

 <h3 id="netutil"> 14. netutil 网络包支持获取 ip 地址，发送 http 请求。&nbsp; &nbsp; &nbsp; &nbsp;<a href="#index">回到目录</a></h3>

@@ -466,12 +466,6 @@ func TestGbkToUtf8(t *testing.T) {
 	assert.Equal("hello", string(utf8Data))
 }

-func decodeBase64(data []byte) ([]byte, error) {
-	buf := make([]byte, base64.StdEncoding.DecodedLen(len(data)))
-	n, err := base64.StdEncoding.Decode(buf, data)
-	return buf[:n], err
-}
-
 func TestToStdBase64(t *testing.T) {
 	t.Parallel()
 	assert := internal.NewAssert(t, "TestToStdBase64")
@@ -903,52 +903,52 @@ import (

 func main() {
    afterEncode := convertor.ToStdBase64(nil)
-	fmt.Println(afterEncode)
+    fmt.Println(afterEncode)

-	afterEncode = convertor.ToStdBase64("")
-	fmt.Println(afterEncode)
+    afterEncode = convertor.ToStdBase64("")
+    fmt.Println(afterEncode)

-	stringVal := "hello"
-	afterEncode = convertor.ToStdBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToStdBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToStdBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToStdBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToStdBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToStdBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToStdBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToStdBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToStdBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToStdBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToStdBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToStdBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToStdBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToStdBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
-	//
-	//
-	// aGVsbG8=
-	// aGVsbG8=
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
-	// MTIzLjQ1Ng==
-	// dHJ1ZQ==
-	// ZXJy
+    // Output:
+    //
+    //
+    // aGVsbG8=
+    // aGVsbG8=
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
+    // MTIzLjQ1Ng==
+    // dHJ1ZQ==
+    // ZXJy
 }

 ```
@@ -975,49 +975,49 @@ import (

 func main() {
    afterEncode := convertor.ToUrlBase64(nil)
-	fmt.Println(afterEncode)
+    fmt.Println(afterEncode)


-	stringVal := "hello"
-	afterEncode = convertor.ToUrlBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToUrlBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToUrlBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToUrlBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToUrlBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToUrlBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToUrlBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToUrlBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToUrlBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToUrlBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToUrlBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToUrlBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToUrlBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToUrlBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
+    // Output:
    //
-	// aGVsbG8=
-	// aGVsbG8=
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
-	// MTIzLjQ1Ng==
-	// dHJ1ZQ==
-	// ZXJy
+    // aGVsbG8=
+    // aGVsbG8=
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
+    // MTIzLjQ1Ng==
+    // dHJ1ZQ==
+    // ZXJy
 }

 ```
@@ -1044,45 +1044,45 @@ import (

 func main() {

-	stringVal := "hello"
-	afterEncode = convertor.ToRawStdBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToRawStdBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToRawStdBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToRawStdBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToRawStdBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToRawStdBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToRawStdBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToRawStdBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToRawStdBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToRawStdBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToRawStdBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToRawStdBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToRawStdBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToRawStdBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
-	// aGVsbG8
-	// aGVsbG8
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
-	// MTIzLjQ1Ng
-	// dHJ1ZQ
-	// ZXJy
+    // Output:
+    // aGVsbG8
+    // aGVsbG8
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
+    // MTIzLjQ1Ng
+    // dHJ1ZQ
+    // ZXJy
 }
 ```

@@ -1108,44 +1108,44 @@ import (

 func main() {

-	stringVal := "hello"
-	afterEncode = convertor.ToRawUrlBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToRawUrlBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToRawUrlBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToRawUrlBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToRawUrlBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToRawUrlBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToRawUrlBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToRawUrlBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToRawUrlBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToRawUrlBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToRawStdBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToRawStdBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToRawStdBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToRawStdBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
-	// aGVsbG8
-	// aGVsbG8
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
-	// MTIzLjQ1Ng
-	// dHJ1ZQ
-	// ZXJy
+    // Output:
+    // aGVsbG8
+    // aGVsbG8
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
+    // MTIzLjQ1Ng
+    // dHJ1ZQ
+    // ZXJy
 }
 ```
@@ -34,6 +34,10 @@ import (
 -   [RoundToFloat](#RoundToFloat)
 -   [RoundToString](#RoundToString)
 -   [TruncRound](#TruncRound)
+-   [CeilToFloat](#CeilToFloat)
+-   [CeilToString](#CeilToString)
+-   [FloorToFloat](#FloorToFloat)
+-   [FloorToString](#FloorToString)
 -   [Range](#Range)
 -   [RangeWithStep](#RangeWithStep)
 -   [AngleToRadian](#AngleToRadian)
@@ -47,6 +51,7 @@ import (
 -   [Log](#Log)
 -   [Sum](#Sum)
 -   [Abs](#Abs)
+-   [Div](#Div)

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

@@ -493,6 +498,150 @@ func main() {
 }
 ```

+### <span id="CeilToFloat">CeilToFloat</span>
+
+<p>向上舍入（进一法），保留n位小数。</p>
+
+<b>函数签名:</b>
+
+```go
+func CeilToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.CeilToFloat(3.14159, 1)
+	result2 := mathutil.CeilToFloat(3.14159, 2)
+	result3 := mathutil.CeilToFloat(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.2
+	// 3.15
+	// 5
+}
+```
+
+### <span id="CeilToString">CeilToString</span>
+
+<p>向上舍入（进一法），保留n位小数，返回字符串。</p>
+
+<b>函数签名:</b>
+
+```go
+func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.CeilToString(3.14159, 1)
+	result2 := mathutil.CeilToString(3.14159, 2)
+	result3 := mathutil.CeilToString(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.2
+	// 3.15
+	// 5.0000
+}
+```
+
+### <span id="FloorToFloat">FloorToFloat</span>
+
+<p>向下舍入（去尾法），保留n位小数。</p>
+
+<b>函数签名:</b>
+
+```go
+func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.FloorToFloat(3.14159, 1)
+	result2 := mathutil.FloorToFloat(3.14159, 2)
+	result3 := mathutil.FloorToFloat(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.1
+	// 3.14
+	// 5
+}
+```
+
+### <span id="FloorToString">FloorToString</span>
+
+<p>向下舍入（去尾法），保留n位小数，返回字符串。</p>
+
+<b>函数签名:</b>
+
+```go
+func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.FloorToString(3.14159, 1)
+	result2 := mathutil.FloorToString(3.14159, 2)
+	result3 := mathutil.FloorToString(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.1
+	// 3.14
+	// 5.0000
+}
+```
+
 ### <span id="Range">Range</span>

 <p>根据指定的起始值和数量，创建一个数字切片。</p>
@@ -978,3 +1127,38 @@ func main() {
 	// 0.2
 }
 ```
+
+### <span id="Div">Div</span>
+
+<p>除法运算.</p>
+
+<b>函数签名:</b>
+
+```go
+func Div[T constraints.Float | constraints.Integer](x T, y T) float64
+```
+
+<b>示例:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.Div(9, 4)
+	result2 := mathutil.Div(1, 2)
+	result3 := mathutil.Div(0, 666)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	// Output:
+	// 2.25
+	// 0.5
+	// 0
+}
+```
@@ -903,52 +903,52 @@ import (

 func main() {
    afterEncode := convertor.ToStdBase64(nil)
-	fmt.Println(afterEncode)
+    fmt.Println(afterEncode)

-	afterEncode = convertor.ToStdBase64("")
-	fmt.Println(afterEncode)
+    afterEncode = convertor.ToStdBase64("")
+    fmt.Println(afterEncode)

-	stringVal := "hello"
-	afterEncode = convertor.ToStdBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToStdBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToStdBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToStdBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToStdBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToStdBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToStdBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToStdBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToStdBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToStdBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToStdBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToStdBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToStdBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToStdBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
-	//
-	//
-	// aGVsbG8=
-	// aGVsbG8=
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
-	// MTIzLjQ1Ng==
-	// dHJ1ZQ==
-	// ZXJy
+    // Output:
+    //
+    //
+    // aGVsbG8=
+    // aGVsbG8=
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
+    // MTIzLjQ1Ng==
+    // dHJ1ZQ==
+    // ZXJy
 }

 ```
@@ -975,49 +975,49 @@ import (

 func main() {
    afterEncode := convertor.ToUrlBase64(nil)
-	fmt.Println(afterEncode)
+    fmt.Println(afterEncode)


-	stringVal := "hello"
-	afterEncode = convertor.ToUrlBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToUrlBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToUrlBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToUrlBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToUrlBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToUrlBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToUrlBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToUrlBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToUrlBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToUrlBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToUrlBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToUrlBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToUrlBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToUrlBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
+    // Output:
    //
-	// aGVsbG8=
-	// aGVsbG8=
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
-	// MTIzLjQ1Ng==
-	// dHJ1ZQ==
-	// ZXJy
+    // aGVsbG8=
+    // aGVsbG8=
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ==
+    // MTIzLjQ1Ng==
+    // dHJ1ZQ==
+    // ZXJy
 }

 ```
@@ -1044,45 +1044,45 @@ import (

 func main() {

-	stringVal := "hello"
-	afterEncode = convertor.ToRawStdBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToRawStdBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToRawStdBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToRawStdBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToRawStdBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToRawStdBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToRawStdBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToRawStdBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToRawStdBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToRawStdBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToRawStdBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToRawStdBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToRawStdBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToRawStdBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
-	// aGVsbG8
-	// aGVsbG8
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
-	// MTIzLjQ1Ng
-	// dHJ1ZQ
-	// ZXJy
+    // Output:
+    // aGVsbG8
+    // aGVsbG8
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
+    // MTIzLjQ1Ng
+    // dHJ1ZQ
+    // ZXJy
 }
 ```

@@ -1108,44 +1108,44 @@ import (

 func main() {

-	stringVal := "hello"
-	afterEncode = convertor.ToRawUrlBase64(stringVal)
-	fmt.Println(afterEncode)
+    stringVal := "hello"
+    afterEncode = convertor.ToRawUrlBase64(stringVal)
+    fmt.Println(afterEncode)

-	byteSliceVal := []byte("hello")
-	afterEncode = convertor.ToRawUrlBase64(byteSliceVal)
-	fmt.Println(afterEncode)
+    byteSliceVal := []byte("hello")
+    afterEncode = convertor.ToRawUrlBase64(byteSliceVal)
+    fmt.Println(afterEncode)

-	intVal := 123
-	afterEncode = convertor.ToRawUrlBase64(intVal)
-	fmt.Println(afterEncode)
+    intVal := 123
+    afterEncode = convertor.ToRawUrlBase64(intVal)
+    fmt.Println(afterEncode)

-	mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
-		A string
-		B int
-	}{"hello", 3}}
-	afterEncode = convertor.ToRawUrlBase64(mapVal)
-	fmt.Println(afterEncode)
+    mapVal := map[string]any{"a": "hi", "b": 2, "c": struct {
+        A string
+        B int
+    }{"hello", 3}}
+    afterEncode = convertor.ToRawUrlBase64(mapVal)
+    fmt.Println(afterEncode)

-	floatVal := 123.456
-	afterEncode = convertor.ToRawUrlBase64(floatVal)
-	fmt.Println(afterEncode)
+    floatVal := 123.456
+    afterEncode = convertor.ToRawUrlBase64(floatVal)
+    fmt.Println(afterEncode)

-	boolVal := true
-	afterEncode = convertor.ToRawStdBase64(boolVal)
-	fmt.Println(afterEncode)
+    boolVal := true
+    afterEncode = convertor.ToRawStdBase64(boolVal)
+    fmt.Println(afterEncode)

-	errVal := errors.New("err")
-	afterEncode = convertor.ToRawStdBase64(errVal)
-	fmt.Println(afterEncode)
+    errVal := errors.New("err")
+    afterEncode = convertor.ToRawStdBase64(errVal)
+    fmt.Println(afterEncode)

-	// Output:
-	// aGVsbG8
-	// aGVsbG8
-	// MTIz
-	// eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
-	// MTIzLjQ1Ng
-	// dHJ1ZQ
-	// ZXJy
+    // Output:
+    // aGVsbG8
+    // aGVsbG8
+    // MTIz
+    // eyJhIjoiaGkiLCJiIjoyLCJjIjp7IkEiOiJoZWxsbyIsIkIiOjN9fQ
+    // MTIzLjQ1Ng
+    // dHJ1ZQ
+    // ZXJy
 }
 ```
@@ -34,6 +34,10 @@ import (
 -   [RoundToFloat](#RoundToFloat)
 -   [RoundToString](#RoundToString)
 -   [TruncRound](#TruncRound)
+-   [CeilToFloat](#CeilToFloat)
+-   [CeilToString](#CeilToString)
+-   [FloorToFloat](#FloorToFloat)
+-   [FloorToString](#FloorToString)
 -   [Range](#Range)
 -   [RangeWithStep](#RangeWithStep)
 -   [AngleToRadian](#AngleToRadian)
@@ -47,6 +51,7 @@ import (
 -   [Log](#Log)
 -   [Sum](#Sum)
 -   [Abs](#Abs)
+-   [Div](#Div)

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

@@ -493,6 +498,150 @@ func main() {
 }
 ```

+### <span id="CeilToFloat">CeilToFloat</span>
+
+<p>Round float up n decimal places.</p>
+
+<b>Signature:</b>
+
+```go
+func CeilToFloat[T constraints.Float | constraints.Integer](x T, n int) float64
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.CeilToFloat(3.14159, 1)
+	result2 := mathutil.CeilToFloat(3.14159, 2)
+	result3 := mathutil.CeilToFloat(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.2
+	// 3.15
+	// 5
+}
+```
+
+### <span id="CeilToString">CeilToString</span>
+
+<p>Round float up n decimal places.</p>
+
+<b>Signature:</b>
+
+```go
+func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.CeilToString(3.14159, 1)
+	result2 := mathutil.CeilToString(3.14159, 2)
+	result3 := mathutil.CeilToString(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.2
+	// 3.15
+	// 5.0000
+}
+```
+
+### <span id="FloorToFloat">FloorToFloat</span>
+
+<p>Round float down n decimal places.</p>
+
+<b>Signature:</b>
+
+```go
+func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.FloorToFloat(3.14159, 1)
+	result2 := mathutil.FloorToFloat(3.14159, 2)
+	result3 := mathutil.FloorToFloat(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.1
+	// 3.14
+	// 5
+}
+```
+
+### <span id="FloorToString">FloorToString</span>
+
+<p>Round float down n decimal places.</p>
+
+<b>Signature:</b>
+
+```go
+func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.FloorToString(3.14159, 1)
+	result2 := mathutil.FloorToString(3.14159, 2)
+	result3 := mathutil.FloorToString(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.1
+	// 3.14
+	// 5.0000
+}
+```
+
 ### <span id="Range">Range</span>

 <p>Creates a slice of numbers from start with specified count, element step is 1.</p>
@@ -964,9 +1113,9 @@ import (
 )

 func main() {
-    result1 := Abs(-1)
-	result2 := Abs(-0.1)
-	result3 := Abs(float32(0.2))
+    result1 := mathutil.Abs(-1)
+	result2 := mathutil.Abs(-0.1)
+	result3 := mathutil.Abs(float32(0.2))

 	fmt.Println(result1)
 	fmt.Println(result2)
@@ -978,3 +1127,38 @@ func main() {
 	// 0.2
 }
 ```
+
+### <span id="Div">Div</span>
+
+<p>returns the result of x divided by y.</p>
+
+<b>Signature:</b>
+
+```go
+func Div[T constraints.Float | constraints.Integer](x T, y T) float64
+```
+
+<b>Example:</b>
+
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/mathutil"
+)
+
+func main() {
+	result1 := mathutil.Div(9, 4)
+	result2 := mathutil.Div(1, 2)
+	result3 := mathutil.Div(0, 666)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	// Output:
+	// 2.25
+	// 0.5
+	// 0
+}
+```
@@ -66,7 +66,7 @@ func Percent(val, total float64, n int) float64 {
 	return result
 }

-// RoundToString round up to n decimal places.
+// RoundToString round off to n decimal places.
 // Play: https://go.dev/play/p/kZwpBRAcllO
 func RoundToString[T constraints.Float | constraints.Integer](x T, n int) string {
 	tmp := math.Pow(10.0, float64(n))
@@ -76,7 +76,7 @@ func RoundToString[T constraints.Float | constraints.Integer](x T, n int) string
 	return result
 }

-// RoundToFloat round up to n decimal places.
+// RoundToFloat round off to n decimal places.
 // Play: https://go.dev/play/p/ghyb528JRJL
 func RoundToFloat[T constraints.Float | constraints.Integer](x T, n int) float64 {
 	tmp := math.Pow(10.0, float64(n))
@@ -100,6 +100,44 @@ func TruncRound[T constraints.Float | constraints.Integer](x T, n int) T {
 	return T(result)
 }

+// FloorToFloat round down to n decimal places.
+// Play: todo
+func FloorToFloat[T constraints.Float | constraints.Integer](x T, n int) float64 {
+	tmp := math.Pow(10.0, float64(n))
+	x *= T(tmp)
+	r := math.Floor(float64(x))
+	return r / tmp
+}
+
+// FloorToString round down to n decimal places.
+// Play: todo
+func FloorToString[T constraints.Float | constraints.Integer](x T, n int) string {
+	tmp := math.Pow(10.0, float64(n))
+	x *= T(tmp)
+	r := math.Floor(float64(x))
+	result := strconv.FormatFloat(r/tmp, 'f', n, 64)
+	return result
+}
+
+// CeilToFloat round up to n decimal places.
+// Play: todo
+func CeilToFloat[T constraints.Float | constraints.Integer](x T, n int) float64 {
+	tmp := math.Pow(10.0, float64(n))
+	x *= T(tmp)
+	r := math.Ceil(float64(x))
+	return r / tmp
+}
+
+// CeilToString round up to n decimal places.
+// Play: todo
+func CeilToString[T constraints.Float | constraints.Integer](x T, n int) string {
+	tmp := math.Pow(10.0, float64(n))
+	x *= T(tmp)
+	r := math.Ceil(float64(x))
+	result := strconv.FormatFloat(r/tmp, 'f', n, 64)
+	return result
+}
+
 // Max return max value of numbers.
 // Play: https://go.dev/play/p/cN8DHI0rTkH
 func Max[T constraints.Integer | constraints.Float](numbers ...T) T {
@@ -253,7 +291,7 @@ func PointDistance(x1, y1, x2, y2 float64) float64 {
 	return math.Sqrt(c)
 }

-// IsPrimes checks if number is prime number.
+// IsPrime checks if number is prime number.
 // Play: https://go.dev/play/p/Rdd8UTHZJ7u
 func IsPrime(n int) bool {
 	if n < 2 {
@@ -351,3 +389,9 @@ func Abs[T constraints.Integer | constraints.Float](x T) T {

 	return x
 }
+
+// Div returns the result of x divided by y.
+// Play: todo
+func Div[T constraints.Float | constraints.Integer](x T, y T) float64 {
+	return float64(x) / float64(y)
+}
@@ -110,6 +110,66 @@ func ExampleTruncRound() {
 	// 0.125
 }

+func ExampleCeilToFloat() {
+	result1 := CeilToFloat(3.14159, 1)
+	result2 := CeilToFloat(3.14159, 2)
+	result3 := CeilToFloat(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.2
+	// 3.15
+	// 5
+}
+
+func ExampleCeilToString() {
+	result1 := CeilToString(3.14159, 1)
+	result2 := CeilToString(3.14159, 2)
+	result3 := CeilToString(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.2
+	// 3.15
+	// 5.0000
+}
+
+func ExampleFloorToFloat() {
+	result1 := FloorToFloat(3.14159, 1)
+	result2 := FloorToFloat(3.14159, 2)
+	result3 := FloorToFloat(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.1
+	// 3.14
+	// 5
+}
+
+func ExampleFloorToString() {
+	result1 := FloorToString(3.14159, 1)
+	result2 := FloorToString(3.14159, 2)
+	result3 := FloorToString(5, 4)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+
+	// Output:
+	// 3.1
+	// 3.14
+	// 5.0000
+}
+
 func ExampleAverage() {
 	result1 := Average(1, 2)
 	result2 := RoundToFloat(Average(1.2, 1.4), 1)
@@ -404,3 +464,17 @@ func ExampleAbs() {
 	// 0.1
 	// 0.2
 }
+
+func ExampleDiv() {
+	result1 := Div(9, 4)
+	result2 := Div(1, 2)
+	result3 := Div(0, 666)
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	// Output:
+	// 2.25
+	// 0.5
+	// 0
+}
@@ -72,8 +72,8 @@ func TestRoundToString(t *testing.T) {
 	assert.Equal("0.12", RoundToString(0.124, 2))
 	assert.Equal("0.13", RoundToString(0.125, 2))
 	assert.Equal("0.125", RoundToString(0.125, 3))
-	//assert.Equal("54.321", RoundToString(54.321, 3))
-	//assert.Equal("17.000", RoundToString(17, 3))
+	assert.Equal("54.321", RoundToString(54.321, 3))
+	assert.Equal("17.000", RoundToString(17, 3))
 }

 func TestTruncRound(t *testing.T) {
@@ -93,6 +93,51 @@ func TestTruncRound(t *testing.T) {
 	assert.Equal(33.33, TruncRound(33.33333, 2))
 }

+func TestFloorToFloat(t *testing.T) {
+	t.Parallel()
+
+	assert := internal.NewAssert(t, "TestFloorToFloat")
+
+	assert.Equal(3.14, FloorToFloat(3.14159, 2))
+	assert.Equal(3.141, FloorToFloat(3.14159, 3))
+	assert.Equal(5.0, FloorToFloat(5, 4))
+	assert.Equal(2.0, FloorToFloat(9/4, 2))
+}
+
+func TestFloorToString(t *testing.T) {
+	t.Parallel()
+
+	assert := internal.NewAssert(t, "TestFloorToString")
+
+	assert.Equal("3.14", FloorToString(3.14159, 2))
+	assert.Equal("3.141", FloorToString(3.14159, 3))
+	assert.Equal("5.0000", FloorToString(5, 4))
+}
+
+func TestCeilToFloat(t *testing.T) {
+	t.Parallel()
+
+	assert := internal.NewAssert(t, "TestCeilToFloat")
+
+	assert.Equal(3.15, CeilToFloat(3.14159, 2))
+	assert.Equal(3.142, CeilToFloat(3.14159, 3))
+	assert.Equal(5.0, CeilToFloat(5, 4))
+	assert.Equal(2.25, CeilToFloat(float32(9)/float32(4), 2))
+	assert.Equal(0.15, CeilToFloat(float64(1)/float64(7), 2))
+}
+
+func TestCeilToString(t *testing.T) {
+	t.Parallel()
+
+	assert := internal.NewAssert(t, "TestCeilToFloat")
+
+	assert.Equal("3.15", CeilToString(3.14159, 2))
+	assert.Equal("3.142", CeilToString(3.14159, 3))
+	assert.Equal("5.0000", CeilToString(5, 4))
+	assert.Equal("2.25", CeilToString(float32(9)/float32(4), 2))
+	assert.Equal("0.15", CeilToString(float64(1)/float64(7), 2))
+}
+
 func TestAverage(t *testing.T) {
 	t.Parallel()

@@ -352,4 +397,19 @@ func TestAbs(t *testing.T) {

 	assert.Equal(int64(1), Abs(int64(-1)))
 	assert.Equal(float32(1), Abs(float32(-1)))
+	assert.Equal(math.Inf(1), Abs(math.Inf(-1)))
+}
+
+func TestDiv(t *testing.T) {
+	t.Parallel()
+
+	assert := internal.NewAssert(t, "TestDiv")
+
+	assert.Equal(float64(2), Div(4, 2))
+	assert.Equal(2.5, Div(5, 2))
+	assert.Equal(0.5, Div(1, 2))
+	assert.Equal(0.5, Div(1, 2))
+	assert.Equal(math.Inf(1), Div(8, 0))
+	assert.Equal(math.Inf(-1), Div(-8, 0))
+	assert.Equal(true, math.IsNaN(Div(0, 0)))
 }
@@ -599,6 +599,7 @@ func SubInBetween(str string, start string, end string) string {
 // HammingDistance calculates the Hamming distance between two strings.
 // The Hamming distance is the number of positions at which the corresponding symbols are different.
 // This func returns an error if the input strings are of unequal lengths.
+// Play: todo
 func HammingDistance(a, b string) (int, error) {
 	if len(a) != len(b) {
 		return -1, errors.New("a length and b length are unequal")
Author	SHA1	Message	Date
dudaodong	a54d4c79a0	doc: update doc for mathutil package	2024-03-04 19:52:49 +08:00
CannianandGitHub	f7b54986aa	feat(mathutil): add DIv, FloorToFloat, FloorToString, CeilToFloat, CeilToString (#199 )	2024-03-04 17:40:31 +08:00
dudaodong	92fae4273b	doc: update doc for new added functions	2024-03-04 16:42:59 +08:00
dudaodong	0d29f5437a	doc: update doc for new added functions	2024-03-04 16:41:54 +08:00