update example readme

Author: nevstop

help/NEVSTOP/Communicable State Machine(CSM)/Examples/Addons - API String Arguments Support(CN).md

@@ -4,76 +4,76 @@
 
 ### Overview
 
-本文展示了CSM API参数中支持的空字符串转换为典型数据类型的示例。空字符串在大多数情况下会被转换为参考数据类型连接的数值。例外场景：
+本范例展示了CSM API参数中支持的空字符串转换为典型数据类型的示例。空字符串在大多数情况下会被转换为参考数据类型连接的数值。例外场景：
 
-- String 数据类型：空字符串会被转换为空字符串。
+- **String数据类型：**空字符串会被转换为空字符串。
 
 ### Introduction
 
-展示不同的空字符串转换为典型数据类型的示例。特别注意 String 数据类型的例外情况。界面会显示参考值和转换后的值，供用户比较。
+展示不同的空字符串转换为典型数据类型的示例。特别注意String数据类型的例外情况。界面会显示参考值和转换后的值，供用户比较。
 
 ### Steps
 
 - step1: 所有的普通类型，空字符串会被转换为参考数据类型连接的数值。
 - step2: String 数据类型，空字符串会被转换为空字符串。
-- step3: timestamp 数据类型，空字符串会转换为当前时间。
+- step3: Timestamp 数据类型，空字符串会转换为当前时间。
 
 ## 2. CSM API String to Typical datatypes.vi
 
 ### Overview
 
-本文展示了CSM API参数中支持的典型数据类型转换为字符串的示例。
+本范例展示了CSM API参数中支持的字符串转换为典型数据类型的示例。
 
 ### Introduction
 
-本文展示了一些典型的字符串转换为典型的数据类型的实例。
+本范例展示了一些典型的字符串转换为典型的数据类型的实例。
 
 ### Steps
 
-- step1: 路径字符串转换为 path 数据类型
+- step1: 路径字符串转换为path数据类型
 - step2: 字符串数据类型的转换
-- step3: 典型的boolean数据类型的描述可以转换为boolean数据类型。
-- step4: i32 数据类型转换
-- step5: dbl 数据类型的转换
-- step6： 普通的enum 类型转换
-- step7: 具有编号的 enum 数据类型可以只描述枚举字符串，
-- step8: 具有编号的 enum 数据类型转换也可以描述索引编号
+- step3: 典型的Boolean数据类型的描述可以转换为Boolean数据类型。
+- step4: i32数据类型转换
+- step5: DBL数据类型的转换
+- step6: 普通的enum类型转换
+- step7: 具有编号的enum数据类型可以只描述枚举字符串，
+- step8: 具有编号的enum数据类型转换也可以描述索引编号
 - step9: 一维数组类型转换
-- step10：cluster数据类型转换
-- step11: cluster array 数据类型转换
+- step10: Cluster数据类型转换
+- step11: Cluster array数据类型转换
 - step12: 二维数组类型转换
 
 
 ## 3. Incorrect usage collections.vi
 
-### overview
+### Overview
 
-一些不正确的API String 描述情况。
+本范例演示一些不正确的API String描述情况。
 
 ### Instruction
 
-选择 Action 后，运行 VI 并查看结果，不正确的格式转换后与预期数据不匹配。
+选择**Action**后，运行VI并查看结果，不正确的格式转换后与预期数据不匹配。
 
 ### Introduction
 
-Cluster 数据类型是重点描述的情况，因为它的情况比较多。通常它的描述格式是：
+Cluster数据类型是重点描述的情况，因为它的情况比较多。通常cluster数据类型的描述格式是：
 
-1. 标签-数据对(Tag:Value)模式
+1. 标签-数据对（Tag:Value）模式
 2. 无标签模式
 
-本范例演示了一些不正确的API String 描述情况。
+本范例演示了一些不正确的API String描述情况。
 
 ## 常见普通类型数据的转换
 
 ### Float 类型(4.1 CSM API String to Float.vi)
 
 #### Overview
 
-API String 支持的Float 格式包括：普通浮点数、科学计数法以及特殊浮点数。本范例演示了这些格式的转换。
+API String支持的Float格式包括：普通浮点数、科学计数法以及特殊浮点数。本范例演示了这些格式的转换。
 
 #### Introduction
 
-API String 支持的Float 格式包括：普通浮点数、科学计数法以及特殊浮点数。本范例演示了这些格式的转换。例如以下方式：
+API String支持的Float格式包括：普通浮点数、科学计数法以及特殊浮点数。本范例演示了这些格式的转换。例如以下方式：
 
 ```
   - 1.2345
@@ -99,9 +99,9 @@ API String 支持的Float 格式包括：普通浮点数、科学计数法以及
 ```
 
 注意：
- - 空字符串将转换为原型(Prototype)的输入值。
+ - 空字符串将转换为原型（Prototype）的输入值。
  - 默认精度为6位有效数字。可以通过API String - Set Float Precision.vi修改精度。
- - 标签-数据对(Tag:Value)可以被正确解析。标签仅用于提高可读性，转换过程中会被忽略。
+ - 标签-数据对（Tag:Value）可以被正确解析。标签仅用于提高可读性，转换过程中会被忽略。
 
 #### Steps
 
@@ -113,74 +113,82 @@ API String 支持的Float 格式包括：普通浮点数、科学计数法以及
 
 #### Overview
 
-演示API String中包含单位的浮点数转换为浮点数的示例。
+本范例演示API String中包含单位的浮点数转换为浮点数的示例。
 
 #### Introduction
 
-API String 带有单位的浮点数字符串也支持正确解析。
+API String带有单位的浮点数字符串也支持正确解析。
 
 如果浮点数字符串与单位字符串之间存在空格，则浮点数后面的所有内容（包括符号）都被识别为单位字符串。
-例如：1.23mA : 浮点数: 1.23m; 单位: A 1.23 mA : 浮点数: 1.23; 单位: mA
+例如：
+
+1.23mA : 浮点数: 1.23m; 单位: A 
+
+1.23 mA : 浮点数: 1.23; 单位: mA
 
 对于科学计数法表示的浮点数，无论是否存在空格，浮点数后面的字符串都被识别为单位字符串。
-例如：1.23E+5mA: 浮点数: 1.23E+5; 单位: mA 1.23E+5 mA: 浮点数: 1.23E+5; 单位: mA
+例如：
+
+1.23E+5mA: 浮点数: 1.23E+5; 单位: mA 
+
+1.23E+5 mA: 浮点数: 1.23E+5; 单位: mA
 
-e、-e、pi、-pi、inf、+inf、-inf 和 NaN 等特殊浮点数值不支持单位。
+e、-e、pi、-pi、inf、+inf、-inf和NaN等特殊浮点数值不支持单位。
 
 #### Steps
 
 - step1: 不同情况的浮点数单位转换测试
-- step2：API String中的转换依赖于 String To Float_csm.vi，可以在函数选板找到这个函数。
+- step2: API String中的转换依赖于String To Float_csm.vi，可以在函数选板找到这个函数。
 
 ### 复数(4.3 CSM API String to Complex Numeric.vi)
 
 #### Overview
 
-本范例用于演示 API String 对于复数的支持。
+本范例用于演示API String对于复数的支持。
 
 #### Introduction
 
-API String 支持复数类型。a+bi 或 a-bi 格式表示复数。其中 a 和 b 支持所有浮点数的表达方式。
+API String支持复数类型。a+bi或a-bi格式表示复数。其中a和b支持所有浮点数的表达方式。
 
 特殊情况说明：
-- 空字符串将转换为原型(Prototype)的输入值。
-- 标签-数据对(Tag:Value)可以被正确解析。标签仅用于提高可读性，转换过程中会被忽略。
+- 空字符串将转换为原型（Prototype）的输入值。
+- 标签-数据对（Tag:Value）可以被正确解析。标签仅用于提高可读性，转换过程中会被忽略。
 
-### Timestamp 类型(4.4 CSM API String to Timestamp.vi)
+### Timestamp 类型(4.4 CSM API String to TimeStamp.vi)
 
 #### Overview
 
-本范例用于演示 API String 对于时间戳的支持。
+本范例用于演示API String对于时间戳的支持。
 
 #### Introduction
 
-API String 时间戳的标准格式为：TimeStamp_String(Format_String)。其中 Format_String 用于解析 TimeStamp_String。
+API String时间戳的标准格式为：`TimeStamp_String(Format_String)`。其中`Format_String`用于解析`TimeStamp_String`。
 
 特殊情况说明:
-- 当字符串不包含 Format_String 时，TimeStamp_String 应符合 RFC3339 标准格式。
-- "2023-10-31T14:49:39.597Z" 为有效的表达方式.
-- "2023-10-31T22:49:39.597+08:00" 为有效的表达方式.
+- 当字符串不包含`Format_String`时，`TimeStamp_String`应符合RFC3339标准格式。
+- "`2023-10-31T14:49:39.597Z`" 为有效的表达方式.
+- "`2023-10-31T22:49:39.597+08:00`" 为有效的表达方式.
 - 对于时间戳，空字符串将转换为当前时间。
 
-#### steps
+#### Steps
 
 - step1: 空字符串转换为当前时间
 - step2: 标准格式转换为时间戳
-- step3: timestamp转换为 API String，并被正确解析回时间戳数据类型
+- step3: Timestamp转换为API String，并被正确解析回时间戳数据类型
 - step4: TimeStamp_String(Format_String)格式的示例
 
 ### Enum 类型(4.5 CSM API String to Enum(special format).vi)
 
 #### Overview
 
-本范例用于演示 API String 对于枚举类型的支持。
+本范例用于演示API String对于枚举类型的支持。
 
 #### Introduction
 
-API String Enum 定义为 [索引编号(index)][分隔符(separator)][枚举字符串] 格式的字符串。
+API String Enum 定义为[索引编号(index)\][枚举字符串\]格式的字符串。
 
 - 索引编号支持NUMERIC类型的所有表达方式。例如：0x01,0b0001。
-- 分隔符(separator)支持 =,-,_ 三种字符，重复个数不限。
+- 分隔符（separator）支持 =、-、_ 三种字符，重复个数不限。
 
 转换规则：
 
@@ -210,11 +218,11 @@ API String Enum 定义为 [索引编号(index)][分隔符(separator)][枚举字
 
 #### Overview
 
-本范例用于演示 API String 对于数组类型的支持。
+本范例用于演示API String对于数组类型的支持。
 
 #### Introduction
 
-API String中对于Array 的定义，逗号(,) 用于元素分隔，分号(;) 用于行分隔。方括号([ 和 ]) 用作边界符号。对于非复杂的混合数据类型，方括号可以省略。
+API String中对于Array的定义，逗号(,) 用于元素分隔，分号(;) 用于行分隔。方括号([ 和 ]) 用作边界符号。对于非复杂的混合数据类型，方括号可以省略。
 
 示例：
 
@@ -223,47 +231,47 @@ API String中对于Array 的定义，逗号(,) 用于元素分隔，分号(;) 
 
 特殊情况说明:
 
-- 空字符串将转换为原型(Prototype)的输入值。
+- 空字符串将转换为原型（Prototype）的输入值。
 
 #### Steps
 
-- step1: 空字符串转换为原型(Prototype)的输入值
+- step1: 空字符串转换为原型（Prototype）的输入值
 - step2: 一维数组转换
 - step3: 二维数组转换
 
 ### 5.2 Cluster 1D Array to CSM API String.vi
 
 #### Overview
 
-本范例用于演示 Cluster 1D Array 的 CSM API String表达。
+本范例用于演示Cluster 1D Array的CSM API String表达。
 
 #### Introduction
 
-Array 是一种复合数据类型，可能包含不同的数据类型。其中以 Cluster 最为复杂，本范例将展示1D Cluster Array 的 CSM API String 表达字符串。
+Array是一种复合数据类型，可能包含不同的数据类型，其中以Cluster 最为复杂。本范例将展示1D Cluster Array的CSM API String表达字符串。
 
 ### 5.3 Cluster 2D Array to CSM API String.vi
 
 #### Overview
 
-本范例用于演示 Cluster 2D Array 的 CSM API String表达。
+本范例用于演示Cluster 2D Array的CSM API String表达。
 
 #### Introduction
 
-Array 是一种复合数据类型，可能包含不同的数据类型。其中以 Cluster 最为复杂，本范例将展示2D Cluster Array 的 CSM API String 表达字符串。
+Array是一种复合数据类型，可能包含不同的数据类型，其中以 Cluster 最为复杂。本范例将展示2D Cluster Array的CSM API String表达字符串。
 
 ## Cluster 数据类型支持
 
 ### 6.1 Cluster to CSM API String.vi
 
 #### Overview
 
-本范例用于演示 Cluster 的 CSM API String表达。
+本范例用于演示Cluster的CSM API String表达。
 
 #### Introduction
 
-Cluster 是一种复杂类型，它由其他的普通数据类型组成。本范例将展示 Cluster 的 CSM API String 表达字符串。在 API String 中，Cluster 可以表达为两种方式。
+Cluster是一种复杂类型，它由其他的普通数据类型组成。本范例将展示Cluster的CSM API String表达字符串。在API String中，Cluster可以表达为两种方式。
 
-1. 标签-数据对(Tag:Value)模式
+1. 标签-数据对（Tag:Value）模式
 
 在标签-数据对模式下，输入字符串由多个标签-数据对组成，冒号(:)用于分隔标签和数据，分号(;)用于分隔不同元素。花括号({ 和 })用作边界符号。对于非复杂的混合数据类型，花括号可以省略。
 
@@ -273,47 +281,49 @@ Cluster 是一种复杂类型，它由其他的普通数据类型组成。本范
 
 #### Steps
 
-- step1: 标签-数据对(Tag:Value)模式
+- step1: 标签-数据对（Tag:Value）模式
 - step2: 无标签模式
 
 ### 6.2 CSM API String to Cluster.vi
 
 #### Overview
 
-本范例用于演示 Cluster 的 CSM API String表达。
+本范例用于演示Cluster的CSM API String表达。
 
 #### Introduction
 
-Cluster 是一种复杂类型，它由其他的普通数据类型组成。本范例将展示 Cluster 的 CSM API String 表达字符串。在 API String 中，Cluster 可以表达为两种方式。
+Cluster是一种复杂类型，它由其他的普通数据类型组成。本范例展示Cluster的CSM API String表达字符串。在API String中，Cluster可以表达为两种方式。
 
-1. 标签-数据对(Tag:Value)模式
+1. 标签-数据对（Tag:Value）模式：在标签-数据对模式下，输入字符串由多个标签-数据对组成，冒号(:)用于分隔标签和数据，分号(;)用于分隔不同元素。花括号({ 和 })用作边界符号。对于非复杂的混合数据类型，花括号可以省略。其他规则如下：
 
-在标签-数据对模式下，输入字符串由多个标签-数据对组成，冒号(:)用于分隔标签和数据，分号(;)用于分隔不同元素。花括号({ 和 })用作边界符号。对于非复杂的混合数据类型，花括号可以省略。其他规则如下：
+   - 标签对应簇中元素的名称，值会根据对应元素的数据类型进行转换。
 
-标签对应簇中元素的名称，值会根据对应元素的数据类型进行转换。
-只需描述需要修改的元素，与数据原型一致的元素可以省略。
-通过名称匹配元素，顺序无关紧要。
-对于嵌套簇，子簇元素的标签格式为"父簇标签.子簇元素标签"。
-嵌套簇中，如果子簇元素的标签名称唯一，可以省略父簇的标签。
+   - 只需描述需要修改的元素，与数据原型一致的元素可以省略。
 
-2. 无标签模式
 
-对于簇，也支持仅输入数据字符串，各值之间用分号分隔。
+   - 通过名称匹配元素，顺序无关紧要。
+
 
-顺序非常重要。第一个元素值将设置给簇的第一个元素，第二个元素值设置给簇的第二个元素，以此类推。
-如果输入字符串的元素数量少于簇的元素数量，剩余的元素将保持不变。
-如果输入字符串的元素数量多于簇的元素数量，多余的元素将被忽略。
+   - 对于嵌套簇，子簇元素的标签格式为"父簇标签.子簇元素标签"。
+
+
+   - 嵌套簇中，如果子簇元素的标签名称唯一，可以省略父簇的标签。
+
+
+2. 无标签模式：对于簇，也支持仅输入数据字符串，各值之间用分号分隔。顺序非常重要。第一个元素值将设置给簇的第一个元素，第二个元素值设置给簇的第二个元素，以此类推。
+   - 如果输入字符串的元素数量少于簇的元素数量，剩余的元素将保持不变。
+   - 如果输入字符串的元素数量多于簇的元素数量，多余的元素将被忽略。
 
 #### Steps
 
 - step1: 空字符串转换为参考数据
-- step2: 可以只通过 tag 名称修改参考数据中的某个元素数据
+- step2: 可以只通过tag名称修改参考数据中的某个元素数据
 - step3：没有标签且个数只有一个的情况下，将直接修改参考数据的第一个元素数据
-- step4: 没有标签且个数只有一个的情况下，将直接修改参考数据的第一个元素数据,第一个是Array的情况
+- step4: 没有标签且个数只有一个的情况下，将直接修改参考数据的第一个元素数据，第一个是Array的情况
 - step5: 无标签模式
-- step6: 无标签模式, 但是元素个数小于全部个数
-- step7: 可以只通过 tag 名称修改参考数据中的某个元素数据
-- step8：无标签模式，但是其中的boolean 数据使用了其他的表达方式
+- step6: 无标签模式，但是元素个数小于全部个数
+- step7: 可以只通过tag名称修改参考数据中的某个元素数据
+- step8: 无标签模式，但是其中的boolean 数据使用了其他的表达方式
 - step9: 无标签模式，但是元素个数大于全部个数
 - step10: 多层嵌套下，tag的名称可以包含点号(.)，用于表示嵌套簇的层级, 没有歧义的情况下，可以只写最终元素的名称，或者部分子嵌套层级的名称
 
@@ -323,14 +333,10 @@ Cluster 是一种复杂类型，它由其他的普通数据类型组成。本范
 
 #### Overview
 
-通常 Array/Cluster 的嵌套是一个复杂的情况，本范例将展示复杂的Cluster Array 的 CSM API String 表达字符串。但是者并不是一个典型的推荐使用场景。
+通常Array/Cluster的嵌套是一个复杂的情况，本范例展示复杂的Cluster Array的CSM API String表达字符串。但是这并不是一个典型的推荐使用场景。
 
 ###  7.2 Cluster with 2D Array elements.vi
 
 #### Overview
 
-通常 Array/Cluster 的嵌套是一个复杂的情况，本范例将展示2D Cluster Array 的 CSM API String 表达字符串。但是者并不是一个典型的推荐使用场景。
-
-
-
-
+通常Array/Cluster的嵌套是一个复杂的情况，本范例将展示2D Cluster Array的CSM API String表达字符串。但是这并不是一个典型的推荐使用场景。