feat: add RemoveNonPrintable

docs/strutil.md

@@ -45,6 +45,7 @@ import (
 -   [Unwrap](#Unwrap)
 -   [SplitWords](#SplitWords)
 -   [WordCount](#WordCount)
+-   [RemoveNonPrintable](#RemoveNonPrintable)
 
 <div STYLE="page-break-after: always;"></div>
 
@@ -937,4 +938,35 @@ func main() {
     // 0
     // 0
 }
+```
+
+
+### <span id="RemoveNonPrintable">RemoveNonPrintable</span>
+
+<p>Remove non-printable characters from a string.</p>
+
+<b>Signature:</b>
+
+```go
+func RemoveNonPrintable(str string) string
+```
+
+<b>Example:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/strutil"
+)
+
+func main() {
+    result1 := strutil.RemoveNonPrintable("hello\u00a0 \u200bworld\n")
+    result2 := strutil.RemoveNonPrintable("你好😄")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    // Output:
+    // hello world
+    // 你好😄
+}
 ```

docs/strutil_zh-CN.md

@@ -45,6 +45,7 @@ import (
 -   [Unwrap](#Unwrap)
 -   [SplitWords](#SplitWords)
 -   [WordCount](#WordCount)
+-   [RemoveNonPrintable](#RemoveNonPrintable)
 
 <div STYLE="page-break-after: always;"></div>
 
@@ -936,4 +937,35 @@ func main() {
     // 0
     // 0
 }
+```
+
+
+### <span id="RemoveNonPrintable">RemoveNonPrintable</span>
+
+<p>删除字符串中不可打印的字符。</p>
+
+<b>函数签名:</b>
+
+```go
+func RemoveNonPrintable(str string) string
+```
+
+<b>示例:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/strutil"
+)
+
+func main() {
+    result1 := strutil.RemoveNonPrintable("hello\u00a0 \u200bworld\n")
+    result2 := strutil.RemoveNonPrintable("你好😄")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    // Output:
+    // hello world
+    // 你好😄
+}
 ```

docs/validator.md

@@ -29,6 +29,7 @@ import (
 -   [IsAlpha](#IsAlpha)
 -   [IsAllUpper](#IsAllUpper)
 -   [IsAllLower](#IsAllLower)
+-   [IsASCII](#IsASCII)
 -   [IsBase64](#IsBase64)
 -   [IsChineseMobile](#IsChineseMobile)
 -   [IsChineseIdNum](#IsChineseIdNum)
@@ -293,6 +294,46 @@ func main() {
 }
 ```
 
+### <span id="IsASCII">IsASCII</span>
+
+<p>Checks if string is ASCII char.</p>
+
+<b>Signature:</b>
+
+```go
+func IsASCII(str string) bool
+```
+
+<b>Example:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/validator"
+)
+
+func main() {
+    result1 := validator.IsASCII("ABC")
+    result2 := validator.IsASCII("123")
+    result3 := validator.IsASCII("")
+    result4 := validator.IsASCII("😄")
+    result5 := validator.IsASCII("你好")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+
+    // Output:
+    // true
+    // true
+    // true
+    // false
+    // false
+}
+```
+
 ### <span id="IsBase64">IsBase64</span>
 
 <p>Check if the string is base64 string.</p>

docs/validator_zh-CN.md

@@ -29,6 +29,7 @@ import (
 -   [IsAlpha](#IsAlpha)
 -   [IsAllUpper](#IsAllUpper)
 -   [IsAllLower](#IsAllLower)
+-   [IsASCII](#IsASCII)
 -   [IsBase64](#IsBase64)
 -   [IsChineseMobile](#IsChineseMobile)
 -   [IsChineseIdNum](#IsChineseIdNum)
@@ -293,6 +294,46 @@ func main() {
 }
 ```
 
+### <span id="IsASCII">IsASCII</span>
+
+<p>验证字符串全部为ASCII字符。</p>
+
+<b>函数签名:</b>
+
+```go
+func IsASCII(str string) bool
+```
+
+<b>示例:</b>
+
+```go
+import (
+    "fmt"
+    "github.com/duke-git/lancet/v2/validator"
+)
+
+func main() {
+    result1 := validator.IsASCII("ABC")
+    result2 := validator.IsASCII("123")
+    result3 := validator.IsASCII("")
+    result4 := validator.IsASCII("😄")
+    result5 := validator.IsASCII("你好")
+
+    fmt.Println(result1)
+    fmt.Println(result2)
+    fmt.Println(result3)
+    fmt.Println(result4)
+    fmt.Println(result5)
+
+    // Output:
+    // true
+    // true
+    // true
+    // false
+    // false
+}
+```
+
 ### <span id="IsBase64">IsBase64</span>
 
 <p>验证字符串是否是base64编码</p>

strutil/string.go

@@ -360,3 +360,16 @@ func WordCount(s string) int {
 
 	return count
 }
+
+// RemoveNonPrintable remove non-printable characters from a string.
+// Play: todo
+func RemoveNonPrintable(str string) string {
+	result := strings.Map(func(r rune) rune {
+		if unicode.IsPrint(r) {
+			return r
+		}
+		return -1
+	}, str)
+
+	return result
+}

strutil/string_example_test.go

@@ -438,3 +438,14 @@ func ExampleWordCount() {
 	// 0
 	// 0
 }
+
+func ExampleRemoveNonPrintable() {
+	result1 := RemoveNonPrintable("hello\u00a0 \u200bworld\n")
+	result2 := RemoveNonPrintable("你好😄")
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	// Output:
+	// hello world
+	// 你好😄
+}

strutil/string_test.go

@@ -342,3 +342,10 @@ func TestWordCount(t *testing.T) {
 		assert.Equal(v, WordCount(k))
 	}
 }
+
+func TestRemoveNonPrintable(t *testing.T) {
+	assert := internal.NewAssert(t, "TestRemoveNonPrintable")
+
+	assert.Equal("hello world", RemoveNonPrintable("hello\u00a0 \u200bworld\n"))
+	assert.Equal("你好😄", RemoveNonPrintable("你好😄"))
+}

validator/validator.go

@@ -58,6 +58,17 @@ func IsAllLower(str string) bool {
 	return str != ""
 }
 
+// IsASCII checks if string is ASCII char.
+// Play:
+func IsASCII(str string) bool {
+	for i := 0; i < len(str); i++ {
+		if str[i] > unicode.MaxASCII {
+			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

@@ -407,3 +407,24 @@ func ExampleIsGBK() {
 	// Output:
 	// true
 }
+
+func ExampleIsASCII() {
+	result1 := IsASCII("ABC")
+	result2 := IsASCII("123")
+	result3 := IsASCII("")
+	result4 := IsASCII("😄")
+	result5 := IsASCII("你好")
+
+	fmt.Println(result1)
+	fmt.Println(result2)
+	fmt.Println(result3)
+	fmt.Println(result4)
+	fmt.Println(result5)
+
+	// Output:
+	// true
+	// true
+	// true
+	// false
+	// false
+}

validator/validator_test.go

@@ -401,3 +401,13 @@ func TestIsGBK(t *testing.T) {
 	assert.Equal(true, IsGBK(gbkData))
 	assert.Equal(false, utf8.Valid(gbkData))
 }
+
+func TestIsASCII(t *testing.T) {
+	assert := internal.NewAssert(t, "TestIsASCII")
+
+	assert.Equal(true, IsASCII("ABC"))
+	assert.Equal(true, IsASCII("123"))
+	assert.Equal(true, IsASCII(""))
+	assert.Equal(false, IsASCII("😄"))
+	assert.Equal(false, IsASCII("你好"))
+}