ForEach
Overview¶
The ForEach Block is used to loop through a list of items and output each item one at a time. It takes a list of any type (list[ItemT]) as input, and for each item in the list, it sends the item through an output channel. Once all items are processed, the output channel is closed.
This Block is ideal for cases where items need to be processed individually rather than in a batch.
Description¶
Loops through a list of items and outputs them one at a time
Metadata¶
- Category: Function
Configuration Options¶
No configuration options available.
Inputs¶
| Name | Data Type | Description |
|---|---|---|
| items | list[ItemT] |
Outputs¶
| Name | Data Type | Description |
|---|---|---|
| item | OutputChannel[ItemT] |
State Variables¶
No state variables available.
Example(s)¶
Example 1: Loop through a list of numbers¶
- Create a
ForEachBlock. - Provide the input list:
[10, 20, 30]. - The
ForEachBlock will output each number (10,20,30) one at a time.
Example 2: Process a list of strings¶
- Set up a
ForEachBlock. - Provide a list of strings:
["apple", "banana", "cherry"]. - The Block will output each string individually as
"apple","banana", and"cherry".
Example 3: Handle an empty list¶
- Create a
ForEachBlock. - Provide an empty list:
[]. - Since the list is empty, the Block will not output any items but will close the channel immediately.
Error Handling¶
- The
ForEachBlock expects a list as input. If the provided input is not a list, it may result in undefined behavior or errors. - If the list is empty, the Block will simply close the output channel without sending any items.
FAQ¶
What happens if the list is empty?
If the list is empty, the ForEach Block will not send any items and will immediately close the output channel.
Can I use the ForEach Block with asynchronous operations?
The ForEach Block can send items through an output channel, which can then be consumed by other blocks that handle asynchronous operations. However, the ForEach Block itself does not perform any asynchronous processing on the items.
Can I use the ForEach Block with nested lists?
The ForEach Block will treat each item in the list as an individual item, even if the item itself is a list. To iterate over nested lists, additional logic may be needed.