ForEach

Name	Mandatory	Description	Default	Type
⬅️ Input		Sequence/table whose elements or key-value pairs need to be processed.		[Any]{Any}
Output ➡️		Outputs the input value, passed through unchanged.		[Any]{Any}
Apply	No	The processing logic (in the form of a shard or sequence of shards) to apply to the input sequence/table.	none	Shard[Shard]

Processes every element or key-value pair of a sequence/table with the shards specified in the Apply parameter. Note that this shard is able to use the $0 and $1 internal variables, as well as $i for the current index.

Details

This shard is able to use the internal variable $0 and $1 within its Apply parameter.

If a sequence was provided as input, the variable $0 will take the value of the current element of the sequence it is iterating over. ($1 does not exist when iterating over a sequence) For example:

[1 2 3]
ForEach(
  Apply: {
    $0 | Math.Add(1)
  }
)

$0 will take the value of 1 and then 2 and then 3 accordingly.

When iterating over a sequence with elements of different types, $0 will adopt the type of the current element it is iterating over, convert its type as necessary.

If a table was provided as input, the variable $0 will be the current key of the table it is iterating over while $1 will take the value associated with the key. For example:

{
  a: 1
  b: 2
  c: 3
}
ForEach(
  Apply: {
    $0 | LogType("Type") | Log("key")
    $1 | ExpectInt | Math.Add(1)
  }
)

$0 will take the value of "a" and then "b" and then "c" while $1 will take the value of 1 and then 2 and then 3 accordingly.

When iterating over a table, the 'Apply' parameter receives a sequence of two elements as input, where the first element is the key and the second is the value. $0 and $1 are set to these values respectively.

$0 will always be of type String while $1, when iterating over the table will always be of type Any. Convert $1 to the appropriate type as necessary (e.g. using ExpectInt).

Do note that this instance of $0 and $1 are unique to the ForEach shard and do not exist outside of the context of its Apply parameter. Values set to this instance of $0 and $1 will not be reflected on other $0 and $1 created in a different call of another ForEach shard or any other shard that is also able to use $0 and $1.

ForEach returns the input unchanged unlike Map which returns the modified sequence or table.

Examples

Code

{value1: 10 value2: 20 value3: 30} ;;Takes each key-value pair as a sequence
ForEach({
  Log
  Take(1)
  ToInt
  Math.Multiply(10)
  Log
})

 

Code

;; ForEach on a sequence: processes every element in seq order
[2 4 8 10]
ForEach(
  Math.Multiply(10)
  Log
  Math.Multiply(100)
  Log
)

 

---