feat: add IsASCII

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("你好"))
+}