mingyang_text 2023.6.3 → 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.06.03",
-    "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",

package/text.js

@@ -1,3 +1,15 @@
+/**
+author:王甫君
+create time:2018-03-24
+wang.fu.jun@qq.com
+wx/qq:96211
+***************************************
+*/
+
+
+
+
+
 
 /**
  * 对【数字】或【字符】进行【左侧补齐】操作
@@ -491,7 +503,7 @@ module.exports.do_Byte_Truncate = func_Byte_Truncate;
 
 
 /**
- * 找到配对的坐标,匹配不上的时候返回-1
+ * 找到配对的坐标，匹配不上的时候返回-1
  * @param {"目标文本，例如【json串】"} args_Text
  * @param {"右侧的限度位置"} args_LimitIndex
  * @param {"当前字符的位置"} args_CurrentIndex
@@ -531,22 +543,22 @@ module.exports.do_EscapeChar = func_EscapeChar;
 
 
 /**
-* 找到配对的坐标,匹配不上的时候返回-1
+* 返回一个数组，下标0：配对的坐标；下标1：缺失的结束文本个数；匹配不到的时候下标0为【-1】
 * @param {"目标文本，例如【json串】"} args_Text
-* @param {"转义字符，例如【\\】"} args_EscapeChar
 * @param {"开始文本，例如【(<】"} args_BinChar
 * @param {"结束文本，例如【)>】"} args_EndChar
 * @param {"开始位置，应是开始文本的下一位"} args_StartIndex
-* @param {"查找范围，通常是目标文本的长度"} args_Length
+* @param {"查找范围，通常是目标文本的长度"} args_MaxLength
+* @param {"转义字符，例如【\\】"} args_EscapeChar
 */
 function func_PairText
     (
        /*要处理的目标字符串*/ args_Text
-        , /*转义字符例如【\\】*/ args_EscapeChar
         , /*开始字符例如【{[】*/ args_BinChar
         , /*结束字符例如【}]】*/ args_EndChar
-        , /*应该是起始字符的位置+1*/ args_StartIndex
-        , /*一般是输入字符的length*/ args_Length
+        , /*应该是起始字符的位置+1*/ args_StartIndex = 0
+        , /*一般是输入字符的length*/ args_MaxLength = 0
+        , /*转义字符例如【\\】*/ args_EscapeChar = null
     ) {
 
     //起步就是1个
@@ -564,8 +576,18 @@ function func_PairText
     }
 
 
-
-
+    {//参数校验
+        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;
@@ -573,11 +595,14 @@ function func_PairText
     let t_Start = 0;
 
     let t_Even_Number = false;
-    for (; args_StartIndex < args_Length;) {
+    for (; args_StartIndex < args_MaxLength;) {
+
+
+
         t_Start = args_StartIndex;
         do {
             t_Index_End = args_Text.indexOf(args_EndChar, t_Start);
-            if (args_EscapeChar == "" || args_EscapeChar == null) {
+            if (args_EscapeChar == null || args_EscapeChar == "") {
                 break;
             }
             t_Even_Number = func_EscapeChar(args_Text, t_Start, t_Index_End, args_EscapeChar);
@@ -599,7 +624,7 @@ function func_PairText
         t_Start = args_StartIndex;
         do {
             t_Index_Bin = args_Text.indexOf(args_BinChar, t_Start);
-            if (args_EscapeChar == "" || args_EscapeChar == null) {
+            if (args_EscapeChar == null || args_EscapeChar == "") {
                 break;
             }
             t_Even_Number = func_EscapeChar(args_Text, t_Start, t_Index_Bin, args_EscapeChar);