reduce() and merge()

RE: reduce() and merge()

Witold Wozniak — Mon, 28 Aug 2023 12:40:04 GMT

Thank you! I try to read your blog regularly.

RE: reduce() and merge()

Stefan Helzle — Mon, 28 Aug 2023 06:26:53 GMT

Check out my blog post for a use case for reduce().

appian.rocks/.../

RE: reduce() and merge()

Witold Wozniak — Sun, 27 Aug 2023 20:27:00 GMT

Helps a lot! Thank you!

RE: reduce() and merge()

Mathieu Drouin — Sun, 27 Aug 2023 12:32:16 GMT

So basically merge seems to be meant specifically to be used with the "legacy" looping functions (i.e. before a!forEach existed) that took a function/predicate and applied it to a list.

https://docs.appian.com/suite/help/23.3/fnc_looping_apply.html

Now I say legacy, most of the functions in that list can be replaced with forEach with the exception of reduce() which does still has some uses. A real world example that may help you understand how it works would be a string substitution (i.e. you want to subsitute multiple keys in a string). Reduce allows you to loop through the list and apply the function but on each iteration it will take the output from the last iteration as an input to the current iteration.

Case in point, here is the version of the string substitution expression with reduce()

a!localVariables(
  local!text: "My name is ###NAME### and I live in ###CITY###",
  local!keys: {
    "###NAME###",
    "###CITY###"
  },
  local!values: {
    "Mat",
    "Montreal"
  },
  reduce(
    substitute(_, _, _),
    local!text,
    merge(local!keys, local!values)
  )
)

vs if you tried to do the same thing with a!forEach()

a!localVariables(
  local!text: "My name is ###NAME### and I live in ###CITY###",
  local!keys: { "###NAME###", "###CITY###" },
  local!values: { "Mat", "Montreal" },
  a!forEach(
    items: local!keys,
    expression: a!localVariables(
      local!key: fv!item,
      local!value: index(local!values, fv!index, null),
      substitute(local!text, local!key, local!value)
    )
  )
)

Hope this helps!

RE: reduce() and merge()

Witold Wozniak — Sun, 27 Aug 2023 09:47:08 GMT

Thank you, but I might have explained my problem wrong.

I could not come up with a use case, where merge() would be superior over, for example, append() or insert()? I know there's a difference in how these work, but if our goal is just to join arrays, then we have other functions that can accomplish that as well. I wanted to know whether there are cases in which merge() is an objectively better choice, rather than a matter of preference, which seems to be the case when speaking about combining arrays.

With reduce(), again, I understand the premise, but I struggle to find a practical use case that would help me test my understanding of the function.

RE: reduce() and merge()

Mathieu Drouin — Sat, 26 Aug 2023 22:02:19 GMT

For the merge, the documentation seems pretty self explanatory. It merges lists.

docs.appian.com/.../fnc_looping_merge.html

As for the reduce function, this will probably explain it better than I can: blog.khanacademy.org/.../