Converts boolean value into specified integer binary representation and writes it to a byte buffer.
|inBuffer||ByteBuffer||Initial buffer to be expanded|
|inOffset||Integer*||0 -||Write destination position|
|inValue||Bool||Value to be written|
|inFormat||IntegerBinaryFormat||Binary serialization format of integer data|
|inTrueValue||Integer||Integer value representing True|
|inFalseValue||Integer||Integer value representing False|
This filter is intended for generating a raw binary data in the ByteBuffer by writing a properly serialized boolean value into it.
Resulting ByteBuffer data on the outBuffer output is created by expanding data from buffer on the inBuffer input. Data is written starting at the position specified by the inOffset input (in bytes). When written data spans beyond the end of the input buffer the resulting buffer length is expanded (event when inOffset points beyond the end of the input buffer). When the inOffset input is set to Auto data is written at the end of the input buffer.
A boolean value is actually stored as an integer data with contractual numeric value representing True and False. This values can be set respectively on the inTrueValue and inFalseValue inputs. Usually a value of zero is used to represent False, and a value different that zero (most commonly 1 or -1) to represent True. This value is than stored like in the WriteIntegerToBuffer filter.
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
List of possible exceptions:
|DomainError||Input value is out of the valid range for specified integer binary format.|
|DomainError||Not supported integer binary format.|
|IoError||Resulting byte buffer size is too large.|
This filter is available on Basic Complexity Level.
This filter is member of WriteToBuffer filter group.
- ReadBoolFromBuffer – Reads boolean value in specified binary format from byte buffer.