LEFT

从左复制字符

LEFT将第一个输入变量的字符串从左开始的n个字符复制到输出变量。您定义要由第二个输入变量传送的字符数量L。

参数

输入

IN (STRING): 输入字符串
L (INT): 从左复制的输入字符串的字符数量

输出

未定义的输出 (STRING): 复制的字符串

标注

如果将此指令用于UTF-8字符串，请参考数据类型STRING下有关UTF-8字符串的说明。
如果要传送的字符数量大于输入字符串，完整字符串将被复制到输出变量output_string。
如果输出字符串长度大于字段[类型]中对输出变量定义的长度，那么只能保留与输出变量一样多的复制字符。系统变量sys_bIsCarry已设置。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）: 如果在输入或输出中应用的字符串是无效字符串
sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）: 如果在输入或输出中应用的字符串是无效字符串
sys_bIsCarry（对于一次扫描变为TRUE）: 如果输出字符串长度大于字段"类型"中对输出变量定义的长度

示例

POU头

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

	VAR
		input_string: STRING[15]:='Ideas for life';
			(*sample string*)
		output_string: STRING[5]:='';
			(*result: here 'Ideas'*)
		character_number: INT:=5;
			(*characters to be delivered*)
	END_VAR

在此例中，已声明输入变量（input_string和character_number）。相反，可以将字符串（'Ideas for life'）和要传送的字符数量直接输入函数。在POU头和在函数中，字符串必须被置于引号中。

POU本体

从左开始，input_string（'Ideas for life’）的character_number (5)被复制到output_string（'Ideas’）。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_F,LEFT!,Instance,11,0,16,4,,?DIN?DL?C);
B(B_VARIN,,input_string,9,1,11,3,);
B(B_VARIN,,character_number,9,2,11,4,);
B(B_VAROUT,,output_string,16,1,18,3,);
L(1,0,1,4);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

output_string:=LEFT(IN:=input_string, L:=character_number);

IL本体

LD	input_string
LEFT	character_number
ST	output_string