Get Binary Item At Index
File:TArduinoGetBinaryItemAtIndex.png
Summary
Retrieves a specific byte from a binary data stream based on its index.
Description
The **Get Binary Item At Index** component outputs the binary value at a specified index within a stream of bytes. - **Enabled**: When set to *False*, the component passes the entire input through unchanged. - **Index**: Specifies which byte position to extract from the incoming binary data. - **Ignore Out Of Range**: If *True*, no signal is generated when the specified index is outside the data range; if *False*, the **Out Of Range** pin emits a clock pulse in such cases. The component outputs the extracted byte via the **Out** pin, or triggers the **Empty** clock output if the input data is insufficient.
This component is particularly useful for processing fixed-position data from packet structures or parsing protocols where specific byte positions hold meaningful information. :contentReference[oaicite:1]{index=1}
Diagram:
Categories
- File:TArduinoBinaryCategory.png Category Binary - Components related to binary data processing
Properties
- Enabled – When **False**, the component is disabled and passes through input without modification.
- Index – Specifies the byte index to retrieve from the input binary stream.
- Ignore Out Of Range – If **True**, ignores index errors silently; if **False**, triggers the **Out Of Range** clock when the index is invalid.
Pins
- In – Binary input stream.
- Out – The byte located at the specified index.
- Empty – Emits a clock signal when the input doesn't contain enough data to reach the specified index.
- Out Of Range – Emits a clock signal if the specified index is beyond the input length and **Ignore Out Of Range** is **False**.