【キーエンスKV-X】文字列挿入(INSERT)FUNの指令方法とラダープログラム/ST例

キーエンスKV-Xシリーズにおける「文字列挿入(INSERT)」は、文字列に指定した文字列を挿入するファンクションです。

文字列挿入(INSERT)を用いることにより「表示器や外部機器から入力された文字列」や「ラダープログラム内で格納した文字列」に指定した文字列を挿入する回路を作ることができます。

この記事では、キーエンスKV-X500/X300シリーズにおける文字列挿入(INSERT)の指令方法とラダープログラム、ST言語の例について解説します。

注意

この記事中のラダープログラムはKV STUDIO Ver.12で作成しており、対応機種はKV-X500に設定してあります。

1. 文字列挿入の指令方法

文字列挿入(INSERT)はLD表現(ラダープログラム)とST表現(ST言語)で使用することができます。

ST言語

Result := INSERT(In1, In2, P);

文字列挿入(INSERT)は↓の引数で構成されています。

引数	タイプ	データ型	初期値	コメント
EN	IN	BOOL	–	イネーブル入力
ENO	OUT	BOOL	–	イネーブル出力
In1	IN	STRING[65534]	”	挿入対象文字列
In2	IN	STRING[65534]	”	挿入する文字列
P	IN	UINT	0	挿入開始位置(0~)
Result	RETURN	STRING[65534]	–	挿入された文字列結果

注意

挿入後の文字列長が1999バイトを超えると実行時エラーとなります。

LD表現

↓がLD表現で使用したラダープログラム例です。

メモ

文字列挿入(INSERT)はFUN(ファンクション)のため、インスタンス名を指令する必要はありません。

このラダープログラムでは、InFlag(入力フラグ)がON(TRUE)している間、文字列ABCDEFの文字列Bの後(挿入開始位置「2」)に文字列XYZを挿入した文字列ABXYZCDEFをOutStr(出力文字列)に格納します。

挿入された文字列結果には終端コードNULL(00H)が付与されます。

メモ

文字列の定数を指定する場合、文字列を'(シングルクオーテーション)で囲います。

InFlag(入力フラグ)がON(TRUE)中に挿入対象文字列(上記だとABCDEF)や挿入する文字列(上記だとXYZ)が変化すると、OutStr(出力文字列)の結果も追従して変化します。

InFlag(入力フラグ)がON(TRUE)した瞬間のみ文字列を挿入する場合、「InFlag(入力フラグ)を立ち上がり検出(R_TRIG)ファンクションブロック等で微分化する」または「文字列挿入(INSERT)FUNを微分指定する」方法があります。

立ち上がり検出(R_TRIG)ファンクションブロックについては以下のページで解説しております。

【キーエンスKV-X】立ち上がり検出(R_TRIG)FBの指令方法とラダープログラム/ST例

微分指定する場合、命令の引数設定ダイアログで微分(E)にチェックを入れます。

ST表現

↓がST表現で使用したST言語例です。

ST言語

IF InFlag THEN
	OutStr := INSERT(In1 := 'ABCDEF', In2 := 'XYZ', P := UINT#2);
END_IF;

メモ

引数タイプがIN、IN-OUTの場合は、「:=」で引数に値を引き渡します。引数タイプが「OUT」の場合は、「=>」で引数の値を変数に格納します。

このSTでは、InFlag(入力フラグ)がON(TRUE)している間、文字列ABCDEFの文字列Bの後(挿入開始位置「2」)に文字列XYZを挿入した文字列ABXYZCDEFをOutStr(出力文字列)に格納します。※前述のLD表現と同じ動作です。

2.【例題】変数に文字列を挿入する

下記仕様のラダープログラム、STを文字列挿入(INSERT)を用いて解説します。

仕様

スイッチ緑を押すと、Str00に格納されている文字列の3文字目の後に文字列XXXを挿入してStr01に格納する。
Str00の文字列長が3文字以上の場合のみ、挿入処理を行う。
※Str00の文字列長が3文字未満であればスイッチ緑を押しても挿入処理は行わない。

Str00に格納されている文字列の3文字目の後に文字列XXXを挿入してStr01に格納する処理に文字列挿入(INSERT)を使用します。

Str00の文字列長が3文字以上の場合のみ挿入処理を行うため、文字列長検出(LEN)を使用してStr00の文字列長を一度変数に格納します。キーエンスKV-X500/X300シリーズの文字列長検出(LEN)ファンクションについては以下のページで解説しております。

【キーエンスKV-X】文字列長検出(LEN)FUNの指令方法とラダープログラム/ST例

Str00の文字列長を格納した変数と定数”3”を比較して、3以上の場合のみ文字列挿入(INSERT)にて挿入処理を行うようにします。(変数≧定数3)

キーエンスKV-X500/X300シリーズの比較(>=)ファンクションについては以下のページで解説しております。(他の比較についてもまとめて解説しております。)

【キーエンスKV-X】比較(=,<>,<,<=,>,>=)FUNの指令方法とラダープログラム/ST例

タッチパネルの動作イメージ

タッチパネルの動作イメージは以下のようになります。

スイッチ緑を押すと、Str00に格納されている文字列の3文字目の後に文字列XXXを挿入してStr01に格納します。

Str00の文字列長が3文字以上の場合のみ、挿入処理を行います。3文字未満の場合は、スイッチ緑を押しても挿入処理を行いません。

使用する変数

使用する変数は以下になります。

変数	データ型	コメント
SwGreen	BOOL	スイッチ緑
Str00_Len	UINT	文字列00長さ
Str00	STRING[30]	文字列00(挿入対象文字列)
Str01	STRING[30]	文字列01(挿入された文字列結果)

ラダープログラム

ラダープログラムは以下のようになります。

イネーブル入力に_AlwaysOn(常時ON)、対象文字列にStr00、文字列長結果にStr00_Lenを指令することで、Str00に格納されている文字列長(何文字か)を常にStr00_Lenに格納します。(1行目)

メモ

キーエンスKV-X500/X300シリーズにおける_AlwaysOnは『PLCがRUN中は常にONする』システム変数です。

イネーブル入力にSwGreen(スイッチ緑)、Str00_Len>=UINT#3の比較を指令することで、Str00が3文字以上の状態でスイッチ緑を押した場合のみ文字列挿入(INSERT)が実行されます。(2行目の条件)

イネーブル入力に上記、挿入対象文字列にStr00、挿入する文字数に’XXX’、挿入開始位置にUINT#2、挿入された文字列結果にStr01を指令することで、Str00が3文字以上の状態でスイッチ緑を押した場合のみ、Str00の3文字目の後に文字列XXXを挿入した結果をStr01に格納します。(2行目の文字列挿入(INSERT))

ST言語

ST言語は下記のようになります。

ST言語

//Str00の文字列長をStr00_Lenに格納
Str00_Len := LEN(Str00);

//ｽｲｯﾁ緑押下かつStr00_Lenが3以上の場合、Str01にStr00の3文字目後にXXXを挿入した結果を格納
IF SwGreen AND Str00_Len >= UINT#3 THEN
	Str01 := INSERT(In1 := Str00, In2 := 'XXX', P := UINT#3);
END_IF;