INSERT

插入字符

INSERT将字符串IN2从字符位置P之后开始插入字符串IN1中，字符位置0表示字符串的开头，1表示字符串第一个字符之后的位置，以此类推。结果被写入输出变量。

参数

输入

IN1 (STRING): 输入字符串
IN2 (STRING): 要插入输入字符串的字符串
P (INT): 字符串IN2插入输入字符串IN1之后的位置，其中0表示字符串的开头，1表示字符串第一个字符之后的位置

输出

未定义的输出 (STRING): 结果字符串

标注

如果将此指令用于UTF-8字符串，请参考数据类型STRING下有关UTF-8字符串的说明。
如果字符串长度大于声明字段[类型]中对输入变量（IN1和IN2）定义的长度，将出现错误（请参阅sys_bIsCarry以了解错误处理）。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）: 如果在输入或输出中应用的字符串是无效字符串
sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）: 如果在输入或输出中应用的字符串是无效字符串

示例

POU头

所有用于编程此函数的输入和输出变量已在POU头中声明。所有编程语言使用相同的POU头。

	VAR
		input_string1: STRING[32]:='ideas life';
		input_string2: STRING[32]:='for';
		position: INT:=6;
		output_string: STRING[32]:='';
	END_VAR

POU本体

在此例中，已声明输入变量input_string1、input_string2和position。但是，可以将值直接输入函数的输入触针。在POU头和在触针中，字符串值必须被置于引号中。input_string2 ('for ')在字符位置6之后被插入input_string1 ('Ideas life')。在output_value中返回结果('Ideas for life')。在LD示例中，在线模式期间（监控）图标激活，因此可以立即看到结果。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_F,INSERT!,Instance,9,0,14,5,,?DIN1?DIN2?DP?C);
B(B_VARIN,,input_string1,7,1,9,3,);
B(B_VARIN,,input_string2,7,2,9,4,);
B(B_VARIN,,position,7,3,9,5,);
B(B_VAROUT,,output_string,14,1,16,3,);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

output_value:=INSERT(IN1:=input_string1, IN2:=input_string2, P:=6);