mingyang_text 2023.2.24 → 2023.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mingyang_text",
-    "version": "2023.02.24",
+    "version": "2023.06.03",
     "description": "MingYang Packet",
     "main": "text.js",
     "scripts": {
@@ -18,7 +18,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

@@ -305,22 +305,46 @@ module.exports.do_KeyValue_Decode = func_KeyValue_Decode;
  * @param {"源数据包"} args_Datas
  * @param {"分割字符"} args_Split
  * @param {"等于字符"} args_Equal
+ * @param {"是否编码"} args_EncodeUriComponent
+ * @param {"是否排序"} args_Sort
  */
-function func_KeyValue_Encode(args_Datas, args_Split, args_Equal) {
+function func_KeyValue_Encode(args_Datas, args_Split, args_Equal, args_EncodeUriComponent = true, args_Sort = false) {
 
     let temp_Keys = Object.keys(args_Datas);
+    if (true == args_Sort) {
+        temp_Keys.sort();
+    }
+
     let t_Lenth = temp_Keys.length;
     if (t_Lenth == 0) {
         return "";
     }
 
+    let temp_Value = "";
+    let temp_Line = "";
     let i = 0;
-    let temp_Line = encodeURIComponent(temp_Keys[i]) + args_Equal + encodeURIComponent(args_Datas[temp_Keys[i]]);
-    i++;
+
+    {
+        if (true == args_EncodeUriComponent) {
+            temp_Value = encodeURIComponent(args_Datas[temp_Keys[i]]);
+        }
+        else {
+            temp_Value = args_Datas[temp_Keys[i]];
+        }
+        temp_Line = encodeURIComponent(temp_Keys[i]) + args_Equal + temp_Value;
+        i++;
+    }
 
     for (; i < t_Lenth; i++) {
         temp_Line += args_Split;
-        temp_Line += encodeURIComponent(temp_Keys[i]) + args_Equal + encodeURIComponent(args_Datas[temp_Keys[i]]);
+
+        if (true == args_EncodeUriComponent) {
+            temp_Value = encodeURIComponent(args_Datas[temp_Keys[i]]);
+        }
+        else {
+            temp_Value = args_Datas[temp_Keys[i]];
+        }
+        temp_Line += encodeURIComponent(temp_Keys[i]) + args_Equal + temp_Value;
     }
 
     return temp_Line;
@@ -460,4 +484,171 @@ 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;
+
+
+
+
+
+/**
+* 找到配对的坐标,匹配不上的时候返回-1
+* @param {"目标文本，例如【json串】"} args_Text
+* @param {"转义字符，例如【\\】"} args_EscapeChar
+* @param {"开始文本，例如【(<】"} args_BinChar
+* @param {"结束文本，例如【)>】"} args_EndChar
+* @param {"开始位置，应是开始文本的下一位"} args_StartIndex
+* @param {"查找范围，通常是目标文本的长度"} args_Length
+*/
+function func_PairText
+    (
+       /*要处理的目标字符串*/ args_Text
+        , /*转义字符例如【\\】*/ args_EscapeChar
+        , /*开始字符例如【{[】*/ args_BinChar
+        , /*结束字符例如【}]】*/ args_EndChar
+        , /*应该是起始字符的位置+1*/ args_StartIndex
+        , /*一般是输入字符的length*/ args_Length
+    ) {
+
+    //起步就是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];
+    }
+
+
+
+
+
+
+    let t_Index_Bin = 0;
+    let t_Index_End = 0;
+    let t_Start = 0;
+
+    let t_Even_Number = false;
+    for (; args_StartIndex < args_Length;) {
+        t_Start = args_StartIndex;
+        do {
+            t_Index_End = args_Text.indexOf(args_EndChar, t_Start);
+            if (args_EscapeChar == "" || args_EscapeChar == null) {
+                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 == "" || args_EscapeChar == null) {
+                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;