Определение функций и использование map в jq

Можешь объяснить, чем отличаются следующие два варианта?

jq ´def addvalue(f): . + [f]; map(addvalue(.[0]))´

[[1,2],[10,20]]
=> [[1,2,1], [10,20,10]]

jq ´def addvalue(f): f as $x | map(. + $x); addvalue(.[0])´
[[1,2],[10,20]]
=> [[1,2,1,2], [10,20,1,2]]

Спасибо.

Резюме: два варианта функций и способ их вызова отличаются тем, где происходит операция map() и что используется в сложении. Это важно, так как в первом случае map() в вызове заставляет сложение в функции использовать первый элемент каждого отдельного подмассива входного массива. Во втором случае map() выполняется внутри функции, и сложение использует весь первый подмассив входного массива.

В первой функции,

def addvalue(f): . + [f];

вы добавляете массив [f] к тому, что предполагается как массив во входном потоке. Добавление массива к другому массиву приводит к добавлению новых элементов к массиву.

Вы вызываете эту функцию addvalue() дважды, используя map(); один раз для каждого из массивов [1,2] и [10,20]. В первом вызове [f] будет [1], поэтому вы добавляете 1 как новый элемент в первый массив, получая [1,2,1]. Так же вы получаете [10,20,10] из второго вызова, когда [f] равно [10].

Добавив отладку в функцию,

def addvalue(f): debug | . + [f]

мы получаем следующее при вызове функции, как в вопросе:

["DEBUG:",[1,2]]
["DEBUG:",[10,20]]

Это показывает, что функция вызывается дважды. Значение [f] будет [1] в первом вызове, в результате чего операция [1,2] + [1] дает [1,2,1], а [10] во втором вызове приводит к [10,20] + [10], получая [10,20,10]. Операция map() в вызове объединит эти массивы в [[1,2,1],[10,20,10]].

Во функции

def addvalue(f): f as $x | map(. + $x);

вы вызываете map() на том, что предполагается как массив во входном потоке. Для каждого элемента входного массива вы добавляете $x к этому элементу. Значение $x – это первый элемент массива.

Вы вызываете эту функцию один раз, с массивом [[1,2],[10,20]] в качестве входного массива и [1,2] в качестве аргумента. Для каждого из элементов входного массива, т.е. для [1,2] и [10,20], вы добавляете [1,2] (значение $x, первый элемент массива). Добавление массива к другому массиву приводит к добавлению элементов массивов друг к другу, поэтому вы получите [1,2,1,2] и [10,20,1,2] как два элемента результирующего массива.

Включив отладку во втором варианте функции аналогично первому,

def addvalue(f): debug | f as $x | map(. + $x);

мы получаем на выходе

["DEBUG:",[[1,2],[10,20]]]

Это показывает, что функция вызывается единожды. Операция map() создаст массив, где к каждому элементу входного массива будет добавлено [1,2], в результате чего получится [[1,2,1,2],[10,20,1,2]].

Чтобы сделать первый вариант функции работать как второй, вам нужно будет вызвать его следующим образом

.[0] as $x | map(addvalue($x[]))

Чтобы сделать второй вариант функции работать как первый, вам нужно будет вызвать его так

[ .[] as $x | [$x] | addvalue([$x[0]]) | add ]