CONCAT（字符串连接）
合并字符串指令用于把两个字符串合并成一个字符串。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR1 | STRING(255) | 输入字符串 | 最大长度 255，输入参数长度超限则取其前255个字符参与运算。 |
| STR2 | STRING(255) | 输入字符串 | 最大长度 255，输入参数长度超限则取其前255个字符参与运算。 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| CONCAT | STRING(255) | 返回子字符串 | (1) (STR1长度+STR2长度) <= 255，输出STR1+STR2；(2) (STR1长度+STR2长度) > 255，输出STR1+STR2的前255个字符。 |
使用举例
通过下面的组态，当STR1=New, STR2=Project, CONCAT会输出 'NewProject'。
| 内容 | 图例 |
|---|---|
| 变量定义 |  |
| 组态语言（CFC） | |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
删除字符串指令用于从字符串的某一位置开始删除部分字符串或全部字符串。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR | STRING(255) | 输入字符串 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| LEN | INT | 要删除的字符个数 | |
| POS | INT | 要删除的字符在 Str 字符串中的起始位置 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| DELETE | STRING(255) | 返回字符串 | (1)POS <= 0 或 LEN <= 0，返回STR；(2)POS > STR长度，返回STR；(3)(POS + LEN – 1) >= STR长度，返回STR前POS - 1个字符；(4)(POS + LEN – 1) < STR长度，则从STR的第POS个位置开始删除LEN个字符，返回剩余的字符串。 |
使用举例
通过下面的组态，当STR=Newproject, LEN=7, POS=4, DELETE会输出 'New'。
| 内容 | 图例 |
|---|---|
| 变量定义 |  |
| 组态语言（CFC） |  |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
FIND（字符串查找）
查找字符串指令用于查找字符串2在字符串1中出现的位置。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR1 | STRING(255) | 输入字符串1 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| STR2 | STRING(255) | 输入字符串2 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| FIND | DINT | 返回值 | (1)如果STR2在STR1中出现，则返回STR1中首次出现STR2的起始位置，1表示第一个字符位置；(2)如果没有出现，则返回0；(3)如果两个输入都为空字符串，则返回0。 |
使用举例
通过下面的组态，当STR1=Newproject, STR2=project, FIND会输出 4。
| 内容 | 图例 |
|---|---|
| 变量定义 |  |
| 组态语言（CFC） |  |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
INSERT（字符串插入）
插入字符串指令用于在第一个字符串的第POS个位置后插入第二个字符串。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR1 | STRING(255) | 输入字符串1 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| STR2 | STRING(255) | 输入字符串2 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| POS | INT | STR2 字符串要插入到 STR1 字符串中的起始位置 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| INSERT | STRING(255) | 返回字符串 | (1)POS < 0，返回STR1；(2)POS = 0，将STR2插入到STR1前面；(3)0 < POS <= STR1长度，把STR2插入到STR1的第POS个字符之后；(4)POS > STR1长度，返回STR1。 如果插入之后的结果超过255个字符，则返回前255个字符。 |
使用举例
通过下面的组态，当STR1=New, STR2=Project, POS=3, INSERT会输出 'NewProject'。
| 内容 | 图例 |
|---|---|
| 变量定义 |  |
| 组态语言（CFC） |  |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
LEFT（字符串取左）
左边取字符串指令用于获取输入字符串左侧N个字符 。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR | STRING(255) | 输入字符串 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| SIZE | DINT | 要返回的子字符串长度 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| LEFT | STRING(255) | 返回子字符串 | (1)SIZE <= 0，则返回空；(2)SIZE <= STR长度，返回STR左侧SIZE个字符；(3)SIZE > STR长度，返回STR，则返回 STR。 |
使用举例
通过下面的组态，当STR=Newproject, SIZE=6, LEFT会输出 'Newpro'。
| 内容 | 图例 |
|---|---|
| 变量定义 |  |
| 组态语言（CFC） |  |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
LEN（字符串长度）
取字符串长度指令用于计算输入字符串的长度。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR | STRING(255) | 输入字符串 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| LEN | DINT | 返回输入字符串的长度 |
使用举例
通过下面的组态，当STR=Newproject, LEN会输出 10。
| 内容 | 图例 |
|---|---|
| 变量定义 |   |
| 组态语言（CFC） |  |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
MID（字符串取中）
中间取字符串指令 MID 用于取字符串第POS个字符开始的LEN个字符。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR | STRING(255) | 输入字符串 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| LEN | INT | 要返回的子字符串长度 | |
| POS | INT | 要返回的子字符串的起始位置 | 1表示第一个字符的位置 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| MID | STRING(255) | 返回子字符串 | (1)POS <= 0 或 LEN <= 0，返回空；(2)POS > STR长度，则返回空；(3)(POS + LEN – 1) < STR长度，返回STR的第POS个字符开始的LEN个字符；(4)(POS + LEN – 1) >= STR长度，返回STR的第POS个位置开始的所有字符。 |
使用举例
通过下面的组态，当STR=Newproject, LEN=4, POS=4, MID会输出 'proj'。
| 内容 | 图例 |
|---|---|
| 变量定义 |  |
| 组态语言（CFC） |  |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
REPLACE（字符串替换）
替换字符串指令用于用字符串2替换字符串1中第POS位置开始的LEN个字符。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR1 | STRING(255) | 输入字符串1 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| STR2 | STRING(255) | 输入字符串2 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| LEN | INT | 要替换的字符个数 | |
| POS | INT | 要替换的字符在 str1 字符串中的起始位置 | 1表示第一个字符 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| REPLACE | STRING(255) | 返回字符串 | (1)POS <= 0 或 LEN <= 0，返回STR1；(2)POS > STR1长度，返回STR1；(3)(POS + LEN – 1) < STR1长度，返回【STR1的前(POS – 1) 个字符】 + 【STR2】 + 【STR1的第 (POS + LEN – 1) 位置后的所有字符】；(4) (POS + LEN – 1) >= STR1长度，返回(STR的前POS – 1 个字符) + STR2。 如果替换之后的结果超过255个字符，则返回前255个字符。 |
使用举例
通过下面的组态，当STR1=Newproject, STR2=Demo, LEN=7, POS=4, REPLACE会输出 'NewDemo'。
| 内容 | 图例 |
|---|---|
| 变量定义 |  |
| 组态语言（CFC） | |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |
RIGHT（字符串取右）
右边取字符串指令用于获取输入字符串右侧N个字符。
参数
| 输入参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| STR | STRING(255) | 输入字符串 | 最大长度 255，超出时，取其前255个字符参与运算。 |
| SIZE | DINT | 要返回的子字符串长度 |
| 输出参数 | 数据类型 | 功能描述 | 参数值说明 |
|---|---|---|---|
| RIGHT | STRING(255) | 返回子字符串。 | (1)SIZE <= 0，则返回空；(2)SIZE <= STR长度，返回STR右侧SIZE个字符；(3)SIZE > STR长度，返回STR。 |
使用举例
通过下面的组态，当STR=Newproject, SIZE=7, RIGHT会输出 'project'。
| 内容 | 图例 |
|---|---|
| 变量定义 | |
| 组态语言（CFC） |  |
| 组态语言（IL） |  |
| 组态语言（LD） |  |
| 组态语言（ST） |  |