Array Transformer

Array transformers can be used on a value data type of Array, including arrays coming from other transformers, such as by using dot notation on a dictionary. Note that all indexes used in dictionaries start from 0. Following transformers are available:

first

Returns the first element in the array.

• Usage: .first()

• Example usage: array.first()

• Example: ["bob", "dan", "oleg"] to bob

until

Returns first N elements of the array. If the array is not sufficiently long, will return the entire array.

• Usage: .until(n)

• Example usage: array.until(2)

• Example: ["bob", "dan", "oleg"] to ["bob", "dan"]

last

Returns the last element in the array.

• Usage: .last()

• Example usage: array.last()

• Example: ["bob", "dan", "oleg"] to oleg

from

Returns array starting from the Nth element. If the index is beyond bounds, will return an empty array.

• Usage: .from(n)

• Example usage: array.from(1)

• Example: ["bob", "dan", "oleg"] to ["dan", "oleg"]

at

Returns the Nth element of the array.

• Usage: .at(n)

• Example usage: array.at(1)

• Example: ["bob", "dan", "oleg"] to dan

range

Returns N elements of the array, starting at index M. If the array is not sufficiently long, will be trimmed from the end.

• Usage: .range(n, m)

• Example usage: array.range(1, 1)

• Example: ["bob", "dan", "oleg"] to ["bob"]

random

Returns a random element of the array.

• Usage: .random()

• Example usage: array.random()

• Example: ["bob", "dan", "oleg"] to bob or any other element, based on your luck :)

shuffled

Returns shuffled array.

• Usage: .shuffled()

• Example usage: array.shuffled()

• Example: ["bob", "dan", "oleg"] to ["dan", "oleg", "bob"] or any other combination, based on your luck :)

sorted

Returns sorted version of the array. Only works on String or Int arrays, otherwise array remains the same as the source.

• Usage: .sorted()

• Example usage: array.sorted()

• Example: ["bob", "oleg", "dan"] to ["bob", "dan", "oleg"]

reversed

Returns reversed version of the array, meaning the first element will be last and vice versa.

• Usage: .reversed()

• Example usage: array.reversed()

• Example: ["bob", "dan", "oleg"] to ["oleg", "dan", "bob"]

enumerated

Returns dictionary with index-based keys and values of source array. This is very useful for loops to obtain index alongside data for each cycle. Enumeration index starts with 0.

• Usage: .enumerated()

• Example usage: array.enumerated()

• Example: ["bob", "dan"] to [0: "oleg", 1: "dan"]

append

Returns array with one additional item pushed into it.

• Usage: .append(item)

• Example usage: array.append("dan")

• Example: ["bob"] to ["bob", "dan"]

join

Returns string that is made by joining all other strings inside an array, joined by a separator. Will throw an error when the array contains something else than just strings.

• Usage: .join(separator)

• Example usage: array.join(", ")

• Example: ["bob", "dan"] to "bob, dan"

concat

Returns array joined with another array.

• Usage: .concat(array)

• Example usage: array.contact(["dan"])

• Example: ["bob"] + ["dan"] to ["bob", "dan"]

count

Returns the size of the array.

• Usage: .count()

• Example usage: array.count()

• Example return: ["bob", "dan", "oleg"] to 3