Differences

This shows you the differences between two versions of the page.

Link to this comparison view

aql:fzip [2020/02/06 22:43] (current)
optrix created
Line 1: Line 1:
 +====ZIP====
  
 +===Parameters===
 +
 +^Order^Name^Type^Desc^
 +|1|A|[[asset list]], [[property list]], [[relationship list]], [[map]]|The first list|
 +|1|B|As above|The second list|
 +
 +or
 +
 +^Order^Name^Type^Desc^
 +|1|Count|[[const|const]]|The number of lists to zip together.|
 +
 +===Returns===
 +
 +Places an item of the same type as passed to the command on the stack.
 +
 +===Description===
 +
 +This function combines two or more lists of the same type into a new list containing all of the items in each list.
 +
 +Unlike [[fAPPEND]],​ this function does **not** remove duplicate items.
 +
 +Instead of simply adding list B at the end of list A, this function '​zips'​ the two lists together by adding alternating items from each list.
 +
 +If **A** is ('​A',​ '​B',​ '​C'​) and **B** is ('​D',​ '​E',​ '​F'​),​ the resulting list would be...
 +
 +('​A','​D','​B','​E','​C','​F'​)
 +
 +This function is often used when you want to combine items that do not have a suitable relationship that would allow the use of a [[fFOR]].
 +
 +===See Also===
 +
 +[[fAPPEND]]