up: update and add some string helper methods

Author: inhere

Diff for: src/Str/Traits/StringCheckHelperTrait.php

@@ -476,7 +476,17 @@ public static function hasSuffixes(string $str, array|string $needles): bool
      */
     public static function isVarName(string $string): bool
     {
-        return preg_match('@^[a-zA-Z_\x7f-\xff][a-zA-Z\d_\x7f-\xff]*@i', $string) === 1;
+        return preg_match('@^[a-zA-Z_\x7f-\xff][a-zA-Z\d_\x7f-\xff]*$@i', $string) === 1;
+    }
+
+    /**
+     * @param string $str
+     *
+     * @return bool
+     */
+    public static function isAlphaNum(string $str): bool
+    {
+        return preg_match('/^[a-zA-Z0-9]+$/', $str) === 1;
     }
 
     /**

Diff for: src/Str/Traits/StringConvertTrait.php

@@ -16,6 +16,7 @@
 use function array_values;
 use function count;
 use function explode;
+use function implode;
 use function is_numeric;
 use function mb_convert_encoding;
 use function mb_convert_variables;
@@ -118,6 +119,24 @@ public static function toTyped(string $str, bool $parseBool = false, int $intMax
         return $str;
     }
 
+    /**
+     * like implode() but support any type
+     *
+     * @param array $list
+     * @param string $sep
+     *
+     * @return string
+     */
+    public static function join(array $list, string $sep = ','): string
+    {
+        $strings = [];
+        foreach ($list as $value) {
+            $strings[] = DataHelper::toString($value, true);
+        }
+
+        return implode($sep, $strings);
+    }
+
     ////////////////////////////////////////////////////////////////////////
     /// split to array
     ////////////////////////////////////////////////////////////////////////
@@ -452,4 +471,44 @@ public static function splitUnicode2(string $str, int $length = 1): array
 
         return $tmp;
     }
+
+    /**
+     * split string to two-node strings.
+     *
+     * eg: "name=tom" => ['name', 'tom']
+     *
+     * @param string $str
+     * @param string $sep
+     *
+     * @return array
+     */
+    public static function split2node(string $str, string $sep = '='): array
+    {
+        $nodes = self::splitTrimmed($str, $sep, 2);
+
+        return count($nodes) === 2 ? $nodes : [$nodes[0], ''];
+    }
+
+    /**
+     * @param string $text multi line text
+     * @param string $lineSep
+     * @param string $valSep
+     *
+     * @return array
+     */
+    public static function splitKvMap(string $text, string $lineSep = "\n", string $valSep = '='): array
+    {
+        $map = [];
+
+        foreach (explode($lineSep, $text) as $line) {
+            if (!$line = trim($line)) {
+                continue;
+            }
+
+            [$k, $v] = self::split2node($line, $valSep);
+            $map[$k] = $v;
+        }
+
+        return $map;
+    }
 }

Diff for: src/Str/Traits/StringLengthHelperTrait.php

@@ -48,12 +48,12 @@ public static function len(int|string $string): int
     }
 
     /**
-     * @param string $str
+     * @param string|int $str
      * @param string $encoding
      *
      * @return int
      */
-    public static function len2(string $str, string $encoding = 'UTF-8'): int
+    public static function len2(string|int $str, string $encoding = 'UTF-8'): int
     {
         $str = (string)$str;
 
@@ -79,11 +79,11 @@ public static function strlen(mixed $str, string $encoding = 'UTF-8', bool $deco
     }
 
     /**
-     * @param string $string
+     * @param string|int $string $string
      *
      * @return int
      */
-    public static function utf8Len(string $string): int
+    public static function utf8Len(string|int $string): int
     {
         // strlen: one chinese is 3 char.
         // mb_strlen: one chinese is 1 char.
@@ -92,11 +92,11 @@ public static function utf8Len(string $string): int
     }
 
     /**
-     * @param string $string
+     * @param string|int $string
      *
      * @return int
      */
-    public static function utf8width(string $string): int
+    public static function utf8width(string|int $string): int
     {
         // strlen: one chinese is 3 char.
         // mb_strlen: one chinese is 1 char.
@@ -107,21 +107,21 @@ public static function utf8width(string $string): int
     /**
      * 计算字符长度
      *
-     * @param string $str
+     * @param string|int $str
      *
      * @return int
      */
-    public static function length(string $str): int
+    public static function length(string|int $str): int
     {
         if ($str === '') {
             return 0;
         }
 
         if (function_exists('mb_strlen')) {
-            return mb_strlen($str, 'utf-8');
+            return mb_strlen((string)$str, 'utf-8');
         }
 
-        preg_match_all('/./u', $str, $arr);
+        preg_match_all('/./u', (string)$str, $arr);
 
         return count($arr[0]);
     }