REPLACEB

The REPLACEB function replaces the specified section of bytes from the input data with the specified replacement data.

Input

Number of Connections: Min: 2/Max:4
InputData TypeDescription
Input1Binary,StringThe original data.
Input2Binary,StringThe replacement data.
Input3IntegerSets the Offset property. (optional)
Input4IntegerSets the Count property. (optional)

Output

OutputData TypeDescription
Output1Binary,StringThe new, modified data.

Property

NameProperty TypeDescription
OffsetIntegerThe offset, in bytes, from the start of the input data from which byte data is selected. The first byte in the input data is "1".
CountIntegerThe number of bytes to select.
EncodingchoiceIf the input is a String, this property specifies the type of encoding used to convert it to binary code. Also, this encoding is used to encode the output string.

utf-8 - Unicode utf-8
shift_jis - Shift JIS
euc-jp - EUC-JP
iso-2022-jp - ISO-2022-JP
utf-16 - Unicode utf-16
OutputTypechoiceSpecifies the output's data type.

Binary - Outputs Binary data.
String - Outputs String data.

Topic


How a Binary function handles String to Byte conversions

The binary representation of a string is dependant on its encoding scheme. Two different encoding schemes may have the same binary representation of a text string. Similarly, two different encoding schemes may have different binary representations for the same text string. Below are some encoding schemes and their resulting binary representations for the string "aeiou".

euc-jp: 61 65 69 6F 75

shift_jis: 61 65 69 6F 75

utf-8: 61 65 69 6F 75

utf-16: FE FF 00 61 00 65 00 69 00 6F 00 75

The Binary Functions LEFTB, RIGHTB, MIDB, REPLACEB and TRUNCATEB handle input streams differently, depending on the input's data type. Binary data is processed as it is. Any other type of input, other than binary data, is first converted to a string (a string is left as is), and then this string is then converted to its binary form according to the encoding scheme selected.

The LEFTB, RIGHTB, MIDB, REPLACEB and TRUNCATEB functions can output the processed binary data or convert it to the specified encoding scheme's string representation for output.

If binary data cannot be successfully converted back to a string, an empty string is output.


Example

PropertyOutput
Input10x616569Offset30x61656F75
Input20x6F75Count2
Encodingutf-8
OutputTypeBinary

PropertyOutput
Input10x616569Offset3aeou
Input20x6F75Count2
Encodingutf-8
OutputTypeString