release v2.1.18

README.md

@@ -4,7 +4,7 @@
 <br/>
 
 ![Go version](https://img.shields.io/badge/go-%3E%3Dv1.18-9cf)
-[![Release](https://img.shields.io/badge/release-2.1.17-green.svg)](https://github.com/duke-git/lancet/releases)
+[![Release](https://img.shields.io/badge/release-2.1.18-green.svg)](https://github.com/duke-git/lancet/releases)
 [![GoDoc](https://godoc.org/github.com/duke-git/lancet/v2?status.svg)](https://pkg.go.dev/github.com/duke-git/lancet/v2)
 [![Go Report Card](https://goreportcard.com/badge/github.com/duke-git/lancet/v2)](https://goreportcard.com/report/github.com/duke-git/lancet/v2)
 [![test](https://github.com/duke-git/lancet/actions/workflows/codecov.yml/badge.svg?branch=main&event=push)](https://github.com/duke-git/lancet/actions/workflows/codecov.yml)
@@ -709,7 +709,14 @@ import "github.com/duke-git/lancet/v2/mathutil"
 -   **<big>RangeWithStep</big>** : Creates a slice of numbers from start to end with specified step.
     [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#Range)]
     [[play](https://go.dev/play/p/akLWz0EqOSM)]
-
+-   **<big>AngleToRadian</big>** : converts angle value to radian value.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#AngleToRadian)]
+-   **<big>RadianToAngle</big>** : converts radian value to angle value.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#RadianToAngle)]
+-   **<big>PointDistance</big>** : get two points distance.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#PointDistance)]
+-   **<big>IsPrime</big>** : checks if number is prime number.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil.md#IsPrime)]
 
 ### 13. Netutil package contains functions to get net information and send http request.
 
@@ -1032,7 +1039,6 @@ import "github.com/duke-git/lancet/v2/slice"
     [[doc](https://github.com/duke-git/lancet/blob/main/docs/slice.md#KeyBy)]
     [[play](https://go.dev/play/p/uXod2LWD1Kg)]
 
-
 ### 17. Structs package provides several high level functions to manipulate struct, tag, and field.
 
 ```go
@@ -1142,6 +1148,8 @@ import "github.com/duke-git/lancet/v2/strutil"
 -   **<big>WordCount</big>** : return the number of meaningful word of a string, word only contains alphabetic characters.
     [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#WordCount)]
     [[play](https://go.dev/play/p/bj7_odx3vRf)]
+-   **<big>RemoveNonPrintable</big>** : remove non-printable characters from a string.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil.md#RemoveNonPrintable)]
 
 ### 19. System package contain some functions about os, runtime, shell command.
 
@@ -1271,6 +1279,10 @@ import "github.com/duke-git/lancet/v2/validator"
 -   **<big>IsGBK</big>** : check if data encoding is gbk.
     [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator.md#IsGBK)]
     [[play](https://go.dev/play/p/E2nt3unlmzP)]
+-   **<big>IsASCII</big>** : checks if string is all ASCII char.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator.md#IsASCII)]
+-   **<big>IsPrintable</big>** : checks if string is all printable chars.
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator.md#IsPrintable)]
 
 ### 21. xerror package implements helpers for errors.
 

README_zh-CN.md

@@ -4,7 +4,7 @@
 <br/>
 
 ![Go version](https://img.shields.io/badge/go-%3E%3Dv1.18-9cf)
-[![Release](https://img.shields.io/badge/release-2.1.17-green.svg)](https://github.com/duke-git/lancet/releases)
+[![Release](https://img.shields.io/badge/release-2.1.18-green.svg)](https://github.com/duke-git/lancet/releases)
 [![GoDoc](https://godoc.org/github.com/duke-git/lancet/v2?status.svg)](https://pkg.go.dev/github.com/duke-git/lancet/v2)
 [![Go Report Card](https://goreportcard.com/badge/github.com/duke-git/lancet/v2)](https://goreportcard.com/report/github.com/duke-git/lancet/v2)
 [![test](https://github.com/duke-git/lancet/actions/workflows/codecov.yml/badge.svg?branch=main&event=push)](https://github.com/duke-git/lancet/actions/workflows/codecov.yml)
@@ -708,7 +708,14 @@ import "github.com/duke-git/lancet/v2/mathutil"
 -   **<big>RangeWithStep</big>** : 根据指定的起始值，结束值，步长，创建一个数字切片。
     [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#RangeWithStep)]
     [[play](https://go.dev/play/p/akLWz0EqOSM)]
-
+-   **<big>AngleToRadian</big>** : 将角度值转为弧度值。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#AngleToRadian)]
+-   **<big>RadianToAngle</big>** : 将弧度值转为角度值。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#RadianToAngle)]
+-   **<big>PointDistance</big>** : 计算两个坐标点的距离。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#PointDistance)]
+-   **<big>IsPrime</big>** : 判断质数。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/mathutil_zh-CN.md#IsPrime)]
 
 ### 13. netutil 网络包支持获取 ip 地址，发送 http 请求。
 
@@ -1143,7 +1150,8 @@ import "github.com/duke-git/lancet/v2/strutil"
 -   **<big>WordCount</big>** : 返回有意义单词的数量，只支持字母字符单词。
     [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#WordCount)]
     [[play](https://go.dev/play/p/bj7_odx3vRf)]
-
+-   **<big>RemoveNonPrintable</big>** : 删除字符串中不可打印的字符。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/strutil_zh-CN.md#RemoveNonPrintable)]
 
 ### 19. system 包含 os, runtime, shell command 的相关函数。
 
@@ -1273,6 +1281,10 @@ import "github.com/duke-git/lancet/v2/validator"
 -   **<big>IsGBK</big>** : 检查数据编码是否为 gbk（汉字内部代码扩展规范）。
     [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator_zh-CN.md#IsGBK)]
     [[play](https://go.dev/play/p/E2nt3unlmzP)]
+-   **<big>IsASCII</big>** : 验证字符串全部为 ASCII 字符。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator_zh-CN.md#IsASCII)]
+-   **<big>IsPrintable</big>** : 检查字符串是否全部为可打印字符。
+    [[doc](https://github.com/duke-git/lancet/blob/main/docs/validator_zh-CN.md#IsPrintable)]
 
 ### 21. xerror 包实现一些错误处理函数
 

docs/mathutil_zh-CN.md

@@ -39,6 +39,7 @@ import (
 -   [AngleToRadian](#AngleToRadian)
 -   [RadianToAngle](#RadianToAngle)
 -   [PointDistance](#PointDistance)
+-   [IsPrime](#IsPrime)
 
 <div STYLE="page-break-after: always;"></div>
 

docs/validator.md

@@ -51,6 +51,7 @@ import (
 -   [IsWeakPassword](#IsWeakPassword)
 -   [IsZeroValue](#IsZeroValue)
 -   [IsGBK](#IsGBK)
+-   [IsPrintable](#IsPrintable)
 
 <div STYLE="page-break-after: always;"></div>
 
@@ -296,7 +297,7 @@ func main() {
 
 ### <span id="IsASCII">IsASCII</span>
 
-<p>Checks if string is ASCII char.</p>
+<p>Checks if string is all ASCII char.</p>
 
 <b>Signature:</b>
 
@@ -1031,3 +1032,44 @@ func main() {
     // true
 }
 ```
+
+
+### <span id="IsPrintable">IsPrintable</span>
+
+<p>Checks if string is all printable chars.</p>
+
+<b>Signature:</b>
+
+```go
+func IsPrintable(str string) bool
+```
+
+<b>Example:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/validator"
+)
+
+func main() {
+    result1 := validator.IsPrintable("ABC")
+    result2 := validator.IsPrintable("{id: 123}")
+    result3 := validator.IsPrintable("")
+    result4 := validator.IsPrintable("😄")
+    result5 := validator.IsPrintable("\u0000")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+}
+```

docs/validator_zh-CN.md

@@ -51,6 +51,7 @@ import (
 -   [IsWeakPassword](#IsWeakPassword)
 -   [IsZeroValue](#IsZeroValue)
 -   [IsGBK](#IsGBK)
+-   [IsPrintable](#IsPrintable)
 
 <div STYLE="page-break-after: always;"></div>
 
@@ -1031,3 +1032,44 @@ func main() {
     // true
 }
 ```
+
+
+### <span id="IsPrintable">IsPrintable</span>
+
+<p>检查字符串是否全部为可打印字符。</p>
+
+<b>函数签名:</b>
+
+```go
+func IsPrintable(str string) bool
+```
+
+<b>示例:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/validator"
+)
+
+func main() {
+    result1 := validator.IsPrintable("ABC")
+    result2 := validator.IsPrintable("{id: 123}")
+    result3 := validator.IsPrintable("")
+    result4 := validator.IsPrintable("😄")
+    result5 := validator.IsPrintable("\u0000")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+
+    // Output:
+    // true
+    // true
+    // true
+    // true
+    // false
+}
+```

validator/validator.go

@@ -58,8 +58,8 @@ func IsAllLower(str string) bool {
 	return str != ""
 }
 
-// IsASCII checks if string is ASCII char.
-// Play:
+// IsASCII checks if string is all ASCII char.
+// Play: todo
 func IsASCII(str string) bool {
 	for i := 0; i < len(str); i++ {
 		if str[i] > unicode.MaxASCII {
@@ -69,6 +69,20 @@ func IsASCII(str string) bool {
 	return true
 }
 
+// IsPrintable checks if string is all printable chars.
+// Play: todo
+func IsPrintable(str string) bool {
+	for _, r := range str {
+		if !unicode.IsPrint(r) {
+			if r == '\n' || r == '\r' || r == '\t' || r == '`' {
+				continue
+			}
+			return false
+		}
+	}
+	return true
+}
+
 // ContainUpper check if the string contain at least one upper case letter A-Z.
 // Play: https://go.dev/play/p/CmWeBEk27-z
 func ContainUpper(str string) bool {

validator/validator_example_test.go

@@ -428,3 +428,24 @@ func ExampleIsASCII() {
 	// false
 	// false
 }
+
+func ExampleIsPrintable() {
+	result1 := IsPrintable("ABC")
+	result2 := IsPrintable("{id: 123}")
+	result3 := IsPrintable("")
+	result4 := IsPrintable("😄")
+	result5 := IsPrintable("\u0000")
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+	fmt.Println(result5)
+
+	// Output:
+	// true
+	// true
+	// true
+	// true
+	// false
+}

validator/validator_test.go

@@ -411,3 +411,13 @@ func TestIsASCII(t *testing.T) {
 	assert.Equal(false, IsASCII("😄"))
 	assert.Equal(false, IsASCII("你好"))
 }
+
+func TestIsPrintable(t *testing.T) {
+	assert := internal.NewAssert(t, "TestIsPrintable")
+
+	assert.Equal(true, IsPrintable("ABC"))
+	assert.Equal(true, IsPrintable("{id: 123}"))
+	assert.Equal(true, IsPrintable(""))
+	assert.Equal(true, IsPrintable("😄"))
+	assert.Equal(false, IsPrintable("\u0000"))
+}