MAX_LEN

文字列の最大長さの測定

この命令は、入力変数から変数宣言に設定されている文字列の最大長を求め、出力変数に値を書き込みます。

パラメータ

入力

未定義入力 (STRING): POUヘッダに宣言されている文字列変数

出力

未定義出力 (INT): 宣言の文字列の最大長

解説

この命令を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;
		iMaxStringLength: INT:=0;
	END_VAR

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,MAX_LEN!,,20,1,26,3,,?D?C);
B(B_VARIN,,sTestString,18,1,20,3,);
B(B_VAROUT,,iMaxStringLength,26,1,28,3,);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

STボディ

iMaxStringLength := MAX_LEN(sTestString);