The TRUNCATEB function truncates the specified number of bytes from an input binary stream, or the specified number of characters from an input string.
Input | Data Type | Description |
---|---|---|
Input1 | Binary,String | The original data. |
Input2 | Integer | Sets the Length property. (optional) |
Output | Data Type | Description |
---|---|---|
Output1 | Binary,String | The truncated data. |
Name | Property Type | Description | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
StartFrom | choice |
Specifies the direction from which truncation is to be performed.
|
|||||||||||||||
Length | Integer | Specifies the number of bytes, or characters to be truncated. | |||||||||||||||
Encoding | choice | If the input is a string, this property specifies the type of encoding used to convert it to binary. Also, if this function's OutputType is set to String, this encoding is used to encode the truncated binary data to a string.
|
|||||||||||||||
OutputType | choice | Specifies the output's data type.
|
Length
to a value less than one will result in an error.Length
is greater than the length of the input string, an empty string is output.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.
Property | Output | |||
Input1 | 0x6165696F75 | StartFrom | Left | 0x696F75 |
Length | 2 | |||
Encoding | utf-8 | |||
OutputType | Binary |
Property | Output | |||
Input1 | 0x6165696F75 | StartFrom | Right | aei |
Length | 2 | |||
Encoding | utf-8 | |||
OutputType | String |