Map

Name	Mandatory	Description	Default	Type
⬅️ Input		The sequence or table to process.		[Any]{Any}
Output ➡️		The resulting processed sequence or table.		[Any]
Apply	No	The function to apply to each item of the sequence or key-value pair of the table.	none	Shard[Shard]

Processes each element of a sequence or key-value pair of a table using the shards specified in the Apply parameter and outputs the modified sequence or table. 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]
Map(
  Apply: {
    $0 | Math.Add(1)
  }
)
Log("Result") ;; Results in [2 3 4]

$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
}
Map(
  Apply: {
    $0 | Log
    $1 | ExpectInt | Math.Add(1)
  }
)
Log("Result") ;; Results in [2 3 4]

$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 Map 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 Map shard or any other shard that is also able to use $0 and $1.

---