(interlaced: array, …Array) → Array
Takes multiple array, and pairs up each value in those arrays: it creates an array containing each array's first value followed by each array's second value, and so forth. If some values have no matching pair (i.e. one array is longer than the other) then those values are ignored.
(interlaced: (a: 'A', 'B', 'C', 'D'), (a: 1, 2, 3)) is the same as
There are a couple of other macros which accept data in pairs - the most notable being (dm:), which takes data names and data values paired. This macro can help with using such macros. For instance, you can supply an array of (datanames:) and (datavalues:) to (interlaced:), and supply that to (dm:), to produce the original datamap again. Or, you can supply just the names, and use a macro like (repeated:) to fill the other values.
However, (interlaced:) can also be of use alongside macros which accept a sequence: you
can use it to cleanly insert values between each item. For instance, one can pair
an array with another array of spaces, and then convert them to a string with (text:).
(text: ...(interlaced: $arr, (repeated: $arr's length, ' ')) will create a string containing
each element of $arr, followed by a space.
If one of the arrays provided is empty, the resulting array will be empty, as well.