ReplaceB
バイト列の中の指定した位置からバイト列を別のバイト列に置換します。
■入力/出力
接続数: 最小 2/最大 4
| 入力 | データ型 | 説明 |
| 入力1 | Binary | バイト列 |
| 入力2 | Binary | 置換するバイト列 |
| 入力3 | Integer | 存在する場合、開始位置プロパティを置換 |
| 入力4 | Integer | 存在する場合、置換バイト数プロパティを置換 |
| 出力 | データ型 | 説明 |
| 出力1 | Binary | 置換した結果のバイト列 |
■プロパティ
| 名前 | プロパティ型 | 説明 |
| 開始位置 | int | 先頭の位置を1とした置換開始位置をバイト数で指定します。 |
| 置換バイト数 | int | 置換するバイト数を指定します。 |
■備考
-
開始位置に0以下、置換バイト数が負数の場合、エラーとなります。
-
開始位置が入力1バイト列より大きい場合、入力1バイト列の最後に入力2バイト列が追加されます。
-
開始位置+置換バイト数が入力1バイト列より大きい場合、入力1バイト列の開始位置までのバイト列の後に入力2バイト列が追加される形になります。
- 入力2バイト列の長さが0の場合、開始位置から置換バイト数分が削除されます。
■バイナリ関数でのバイト列の取り扱いについて
それぞれのバイナリ関数(LeftB/RightB/MidB/ReplaceB/TruncateB)は入力のバイト列をそのまま処理します。文字を表すバイト列を扱った場合は2バイト文字の途中で切れるなどの文字の泣き別れが発生することがあります。
■例
| プロパティ | 出力 |
| 入力1 | 0x82A082A282A4 | 開始位置 | 3 | 0x82A082A682A4 |
| 入力2 | 0x82A6 | 置換バイト数 | 2 | |