SET_LEN

文字列長の設定

この命令は、入力STRの文字列長を、入力LENに定義されている新しい長さに設定します。新しい文字列変数長が、宣言の文字列最大長さを超えている場合はエラーが発生しbErrorをTRUEにセットします。現在の文字列長より、新しい文字列長の長さが短い場合、文字列は切り捨てられます。

パラメータ

入力

LEN (INT): 新しい文字列の長さ

入出力

STR (STRING): 新しい長さを設定する文字列

出力

bError (BOOL): 新しい文字列の長さが文字列宣言の最大文字列長を超えている場合は、TRUEに設定します。

解説

この命令をUTF-8文字列で使用する場合は、データ型STRINGのUTF-8文字列についての注意事項をご参照ください。

エラーフラグ

sys_bIsOperationErrorHold (TRUEになり、TRUEを保持): 入力または出力に適用される文字列が無効な文字列のとき
sys_bIsOperationErrorNonHold (1回のスキャンに対して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;