map

Function

  map — apply a function to each element of an array or set

Synopsis

map(v: array|set, f: function) -> array|set

Description

The map function applies function f to every element in array or set v and returns an array or set of the results. Function f must be a function that takes only one argument. f may be a user-defined function.

Examples

Upper case each element of an array:

echo '["foo","bar","baz"]' | zq -z 'yield map(this, upper)' -

=>

["FOO","BAR","BAZ"]

Using a user-defined function to convert an epoch float to a time:

echo '[1697151533.41415,1697151540.716529]' | zq -z '
  func floatToTime(x): ( cast(x*1000000000, <time>) )
  yield map(this, floatToTime)
' -

=>

[2023-10-12T22:58:53.414149888Z,2023-10-12T22:59:00.716528896Z]