mingyang_text 2022.10.27 → 2023.1.28

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mingyang_text",
-    "version": "2022.10.27",
+    "version": "2023.01.28",
     "description": "MingYang Packet",
     "main": "text.js",
     "scripts": {

package/text.js

@@ -1,9 +1,9 @@
 
 /**
  * 对【数字】或【字符】进行【左侧补齐】操作
- * @param {"数字或字符"} args_Input 
- * @param {"目标长度"} args_Length 
- * @param {"占位符"} args_PlaceHolder 
+ * @param {"数字或字符"} args_Input
+ * @param {"目标长度"} args_Length
+ * @param {"占位符"} args_PlaceHolder
  */
 function func_StringFormat(args_Input, args_Length, args_PlaceHolder) {
     if (args_Input.toString().length > args_Length) {
@@ -21,8 +21,8 @@ module.exports.do_StringFormat = func_StringFormat;
 
 /**
  * 生成随机数
- * @param {"最小值，随机数可以选中最小值"} args_Min 
- * @param {"最大值，随机数不会选中最大值"} args_Max 
+ * @param {"最小值，随机数可以选中最小值"} args_Min
+ * @param {"最大值，随机数不会选中最大值"} args_Max
  */
 function func_Random(args_Min, args_Max) {
     let temp_Val = Math.floor(Math.random() * (args_Max - args_Min)) + args_Min;
@@ -37,7 +37,7 @@ module.exports.do_Random = func_Random;
 
 /**
  * 格式化时间
- * @param {"时间对象，如果传入空，那么将使用当前时间"} args_Date 
+ * @param {"时间对象，如果传入空，那么将使用当前时间"} args_Date
  * @param {"时间格式，例如【yyyy-MM-dd HH:mm:ss.fff】【yyyyMMddHHmmssfff】"} args_Format
  */
 function func_DateTimeToString(args_Date, args_Format) {
@@ -75,9 +75,9 @@ module.exports.do_DateTimeToString = func_DateTimeToString;
 
 /**
  * 根据给定的左右标签，提取父串中的子串
- * @param {"输入文本"} args_Text 
- * @param {"左侧标记"} args_Bin 
- * @param {"右侧标记"} args_End 
+ * @param {"输入文本"} args_Text
+ * @param {"左侧标记"} args_Bin
+ * @param {"右侧标记"} args_End
  */
 function func_Filter(args_Text, args_Bin, args_End) {
 
@@ -201,7 +201,7 @@ module.exports.do_TimeID = func_TimeID;
 
 /**
  * 从【16进制文本】转换为【普通文本】
- * @param {"16进制文本"} args_Hex 
+ * @param {"16进制文本"} args_Hex
  */
 function func_Hex_goto_Plain(args_Hex) {
     let t_Buffer = Buffer.from(args_Hex, 'hex');
@@ -211,7 +211,7 @@ module.exports.do_Hex_goto_Plain = func_Hex_goto_Plain;
 
 /**
  * 从【普通文本】转换为【16进制文本】
- * @param {"普通文本"} args_Hex 
+ * @param {"普通文本"} args_Hex
  */
 function func_Hex_from_Plain(args_Plain) {
     let t_Buffer = Buffer.from(args_Plain, "utf8");
@@ -225,8 +225,8 @@ module.exports.do_Hex_from_Plain = func_Hex_from_Plain;
 
 /**
  * 【主字符串】是否以【从字符串】开头
- * @param {"主字符串"} args_Subject 
- * @param {"从字符串"} args_Compare 
+ * @param {"主字符串"} args_Subject
+ * @param {"从字符串"} args_Compare
  */
 function func_Bin_With(args_Subject, args_Compare) {
     if (args_Subject == null || args_Compare == null) {
@@ -247,8 +247,8 @@ module.exports.do_Bin_With = func_Bin_With;
 
 /**
  * 【主字符串】是否以【从字符串】结尾
- * @param {"主字符串"} args_Subject 
- * @param {"从字符串"} args_Compare 
+ * @param {"主字符串"} args_Subject
+ * @param {"从字符串"} args_Compare
  */
 function func_End_With(args_Subject, args_Compare) {
     if (args_Subject == null || args_Compare == null) {
@@ -274,9 +274,9 @@ module.exports.do_End_With = func_End_With;
 
 /**
  * KeyValue解码
- * @param {"源字符串"} args_Plain 
- * @param {"分割字符"} args_Split 
- * @param {"等于字符"} args_Equal 
+ * @param {"源字符串"} args_Plain
+ * @param {"分割字符"} args_Split
+ * @param {"等于字符"} args_Equal
  */
 function func_KeyValue_Decode(args_Plain, args_Split, args_Equal) {
 
@@ -299,9 +299,9 @@ module.exports.do_KeyValue_Decode = func_KeyValue_Decode;
 
 /**
  * KeyValue编码
- * @param {"源数据包"} args_Datas 
- * @param {"分割字符"} args_Split 
- * @param {"等于字符"} args_Equal 
+ * @param {"源数据包"} args_Datas
+ * @param {"分割字符"} args_Split
+ * @param {"等于字符"} args_Equal
  */
 function func_KeyValue_Encode(args_Datas, args_Split, args_Equal) {
 
@@ -330,9 +330,9 @@ module.exports.do_KeyValue_Encode = func_KeyValue_Encode;
 
 /**
  * 【十进制数字】转成【它进制数字】
- * @param {"来源十进制数，例如：110715"} args_DecimalNumber 
- * @param {"目标进制基数，例如：62"} args_NumberSystem 
- * @param {"目标记号字符，例如：0123456789ABCDEF"} args_VisibleChar 
+ * @param {"来源十进制数，例如：110715"} args_DecimalNumber
+ * @param {"目标进制基数，例如：62"} args_NumberSystem
+ * @param {"目标记号字符，例如：0123456789ABCDEF"} args_VisibleChar
  */
 function func_DecimalToOther(args_DecimalNumber, args_NumberSystem, args_VisibleChar = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz") {
 
@@ -362,9 +362,9 @@ module.exports.do_DecimalToOther = func_DecimalToOther;
 
 /**
  * 【它进制数字】转成【十进制数字】
- * @param {"来源进制数值，例如：TO80HHL"} args_OtherNumber 
- * @param {"来源进制基数，例如：62"} args_NumberSystem 
- * @param {"来源记号字符，例如：0123456789ABCDEF"} args_VisibleChar 
+ * @param {"来源进制数值，例如：TO80HHL"} args_OtherNumber
+ * @param {"来源进制基数，例如：62"} args_NumberSystem
+ * @param {"来源记号字符，例如：0123456789ABCDEF"} args_VisibleChar
  */
 function func_DecimalFromOther(args_OtherNumber, args_NumberSystem, args_VisibleChar = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz") {
 
@@ -400,7 +400,7 @@ module.exports.do_DecimalFromOther = func_DecimalFromOther;
 
 /**
  * 【10进制数字】转成【62进制数字】
- * @param {"10进制数"} args_Base10Number 
+ * @param {"10进制数"} args_Base10Number
  */
 function func_Base62Encode(args_Base10Number) {
     return func_DecimalToOther(args_Base10Number, 62);
@@ -409,9 +409,26 @@ module.exports.do_Base62Encode = func_Base62Encode;
 
 /**
  * 【62进制数字】转成【10进制数字】
- * @param {"62进制数"} args_Base62Number 
+ * @param {"62进制数"} args_Base62Number
  */
 function func_Base62Decode(args_Base62Number) {
     return func_DecimalFromOther(args_Base62Number, 62);
 }
 module.exports.do_Base62Decode = func_Base62Decode;
+
+
+/**
+ * 按照字节长度截取字符串
+ * @param {"原始字符"} args_InputString
+ * @param {"目标长度"} args_ByteLength
+ * @param {"编码方式"} args_Encoding
+*/
+module.exports.do_Byte_Truncate = (args_InputString, args_ByteLength, args_Encoding = "utf8") => {
+    let temp_Description = args_InputString.substring(0, args_ByteLength);
+    let temp_Buffer = Buffer.from(temp_Description, args_Encoding);
+    while (temp_Buffer.length > args_ByteLength) {
+        temp_Description = temp_Description.substring(0, temp_Description.length - 1);
+        temp_Buffer = Buffer.from(temp_Description, args_Encoding);
+    }
+    return temp_Description;
+}