SET_LEN

设置字符串长度

此指令将输入STR中字符串的字符串长度设置为输入LEN中定义的新长度。如果新长度超过字符串声明的最大长度，将出现错误且bError设置为TRUE。如果定义的新字符串长度小于当前字符串长度，字符串将被截断至新的字符串长度。

参数

输入

LEN (INT): 新的字符串长度

输入/输出

STR (STRING): 设置为新长度的字符串

输出

bError (BOOL): 如果新的字符串长度超过字符串声明的最大字符串长度，设置为TRUE

标注

如果将此指令用于UTF-8字符串，请参考数据类型STRING下有关UTF-8字符串的说明。

错误标志

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

示例

POU头

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

	VAR
		sTestString: STRING[128]:='A better life. A better world';
		iStringLength: INT:=0;
		bError: BOOL:=FALSE;
		bStart: BOOL:=FALSE;
	END_VAR

POU本体

当变量bStart设置为TRUE时，执行此函数。

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,E_SET_LEN!,,24,0,31,5,,?DEN?DLEN?DSTR?ASTR?AENO?CbError);
B(B_CONTACT,,bStart,5,1,7,3,);
B(B_VARIN,,sTestString,22,3,24,5,);
B(B_VAROUT,,bError,31,2,33,4,);
B(B_VARIN,,32,22,2,24,4,);
L(1,2,5,2);
L(7,2,24,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_VAROUT,,iStringLength,29,2,31,4,);
B(B_VARIN,,sTestString,21,2,23,4,);
B(B_F,LEN!,,24,1,29,4,,?DIN?C);
L(23,3,24,3);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If (bStart) then
    bError := SET_LEN(32, sTestSTring);
    iStringLength := LEN(sTestString);
End_if;