Array Transformers

Array transformers can be used on 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"]

count

Returns the size of the array.

  • Usage: .count()

  • Example usage: array.count()

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