mingyang_text 2023.5.18 → 2023.8.26

package/README.md

@@ -0,0 +1,27 @@
+# introduction
+
+* 一个字符串操作的函数集合
+* a collection of string related functions
+---
+
+<br>
+
+# history
+
+* 2023-08-26
+> * 优化了字符串配对函数的参数顺序并增加了默认值
+> * optimized the parameter order of string pairing function and added default values
+
+> * 增加了个readme文件
+> * added a readme file
+---
+
+<br>
+
+# author
+
+* fujun wang（wang.fu.jun@qq.com）
+* Wangjing Beijing China
+* origin of the name : mingyang is my son's name
+* last modified : 2023-08-26
+---

package/package.json

@@ -1,14 +1,12 @@
 {
     "name": "mingyang_text",
-    "version": "2023.05.18",
-    "description": "MingYang Packet",
+    "version": "2023.08.26",
+    "description": "a collection of string related functions",
     "main": "text.js",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": [
-        "mingyang",
-        "mingyang/text",
         "text/bin_with",
         "text/end_with",
         "string/format",
@@ -18,7 +16,10 @@
         "time/uuid",
         "base62",
         "baseX",
-        "any base system"
+        "any base system",
+        "string pair",
+        "char pair",
+        "text pair"
     ],
     "author": "wang.fu.jun@qq.com,wang.ming.yang@126.com",
     "license": "ISC"

package/text.js

@@ -1,3 +1,15 @@
+/**
+author:王甫君
+create time:2018-03-24
+wang.fu.jun@qq.com
+wx/qq:96211
+***************************************
+*/
+
+
+
+
+
 
 /**
  * 对【数字】或【字符】进行【左侧补齐】操作
@@ -484,4 +496,184 @@ function func_Byte_Truncate(args_InputString, args_ByteLength, args_Encoding = "
     }
     return temp_Description;
 }
-module.exports.do_Byte_Truncate = func_Byte_Truncate;
+module.exports.do_Byte_Truncate = func_Byte_Truncate;
+
+
+
+
+
+/**
+ * 找到配对的坐标，匹配不上的时候返回-1
+ * @param {"目标文本，例如【json串】"} args_Text
+ * @param {"右侧的限度位置"} args_LimitIndex
+ * @param {"当前字符的位置"} args_CurrentIndex
+ * @param {"转义字符，例如【\】"} args_EscapeChar
+ */
+function func_EscapeChar
+    (
+       /*目标文本*/ args_Text
+        , /*限度位置*/ args_LimitIndex
+        , /*当前位置*/ args_CurrentIndex
+        , /*转义字符*/ args_EscapeChar
+    ) {
+    let temp_Amount = 0;
+    let temp_Char = "";
+    do {
+        args_CurrentIndex = args_CurrentIndex - 1;
+        if (args_CurrentIndex >= args_LimitIndex) {//如果向前一位置，仍然小于开始位置
+            temp_Char = args_Text.substring(args_CurrentIndex, args_CurrentIndex + 1);
+            if (temp_Char == args_EscapeChar) {//记录一次
+                temp_Amount++;
+            }
+            else {// 否则：停止
+                break;
+            }
+        }
+        else {//否则：停止
+            break;
+        }
+    } while (true);
+
+    return (temp_Amount % 2) == 0;
+}
+module.exports.do_EscapeChar = func_EscapeChar;
+
+
+
+
+
+/**
+* 返回一个数组，下标0：配对的坐标；下标1：缺失的结束文本个数；匹配不到的时候下标0为【-1】
+* @param {"目标文本，例如【json串】"} args_Text
+* @param {"开始文本，例如【(<】"} args_BinChar
+* @param {"结束文本，例如【)>】"} args_EndChar
+* @param {"开始位置，应是开始文本的下一位"} args_StartIndex
+* @param {"查找范围，通常是目标文本的长度"} args_MaxLength
+* @param {"转义字符，例如【\\】"} args_EscapeChar
+*/
+function func_PairText
+    (
+       /*要处理的目标字符串*/ args_Text
+        , /*开始字符例如【{[】*/ args_BinChar
+        , /*结束字符例如【}]】*/ args_EndChar
+        , /*应该是起始字符的位置+1*/ args_StartIndex = 0
+        , /*一般是输入字符的length*/ args_MaxLength = 0
+        , /*转义字符例如【\\】*/ args_EscapeChar = null
+    ) {
+
+    //起步就是1个
+    args_Missing = 1;
+
+    if (args_EndChar == "") {//如果【结束符】是空，那么直接返回最后的位置
+        return [args_Text.length, args_Missing];
+    }
+
+
+
+
+    if (args_BinChar == "") {//如果【开始符】是空，那么直接返回【结束符】的位置
+        return [args_Text.indexOf(args_EndChar, args_StartIndex), args_Missing];
+    }
+
+
+    {//参数校验
+        if (args_MaxLength == 0) {
+            args_MaxLength = args_Text.length;
+        }
+        if (args_StartIndex == 0) {
+            args_StartIndex = args_Text.indexOf(args_BinChar);
+            if (args_StartIndex == -1) {
+                return [args_Text.indexOf(args_EndChar, 0), args_Missing];
+            }
+            args_StartIndex = args_StartIndex + args_BinChar.length;
+        }
+    }
+
+
+    let t_Index_Bin = 0;
+    let t_Index_End = 0;
+    let t_Start = 0;
+
+    let t_Even_Number = false;
+    for (; args_StartIndex < args_MaxLength;) {
+
+
+
+        t_Start = args_StartIndex;
+        do {
+            t_Index_End = args_Text.indexOf(args_EndChar, t_Start);
+            if (args_EscapeChar == null || args_EscapeChar == "") {
+                break;
+            }
+            t_Even_Number = func_EscapeChar(args_Text, t_Start, t_Index_End, args_EscapeChar);
+
+            /**
+             * 只能加1，不能加p_EndChar.length
+             * 案例：
+             *      字符串="aaa0123456\tttt"
+             *      开始符="aaa"
+             *      结束符="ttt"
+             *      转义符="\"
+             */
+            t_Start = t_Index_End + 1;
+        }
+        while (false == t_Even_Number);
+
+
+
+        t_Start = args_StartIndex;
+        do {
+            t_Index_Bin = args_Text.indexOf(args_BinChar, t_Start);
+            if (args_EscapeChar == null || args_EscapeChar == "") {
+                break;
+            }
+            t_Even_Number = func_EscapeChar(args_Text, t_Start, t_Index_Bin, args_EscapeChar);
+
+            /**
+             * 只能加1，不能加p_EndChar.length
+             * 案例：
+             *      字符串="aaa0123456\tttt"
+             *      开始符="aaa"
+             *      结束符="ttt"
+             *      转义符="\"
+             */
+            t_Start = t_Index_Bin + 1;
+        }
+        while (false == t_Even_Number);
+
+
+
+
+
+
+        if (t_Index_End == -1) {
+            return [-1, args_Missing];
+        }
+        else {
+            if (t_Index_Bin > -1) {
+                if (t_Index_End <= t_Index_Bin)//对于【开始符】和【结束符】一样的时候【结束符】优先
+                {
+                    args_Missing--;
+                    args_StartIndex = t_Index_End + args_EndChar.length;
+                }
+                else {
+                    args_Missing++;
+                    args_StartIndex = t_Index_Bin + args_BinChar.length;
+                }
+            }
+            else {
+                {
+                    args_Missing--;
+                    args_StartIndex = t_Index_End + args_EndChar.length;
+                }
+            }
+        }
+
+
+        if (args_Missing == 0) {
+            return [t_Index_End, args_Missing];
+        }
+    }
+    return [-1, args_Missing];
+}
+module.exports.do_PairText = func_PairText;