Duplicate

List command; for linear lists and property lists. Copies the existing list to a new memory address. Subsequent operations on vNewList will not affect vExistingList.

Also elements of vExistingList that are (list-)references are duplicated. (See example below)

Syntax

vList.duplicate()
duplicate(vList)

Examples

vElement = [99,3,3]

vExistingList = [vElement, vElement]
put vExistingList
-- [[99, 3, 3], [99, 3, 3]]

vExistingList[1][1] = 3
put vExistingList
-- [[3, 3, 3], [3, 3, 3]]
-- As expected, both references of vElement changed.

vNewList = duplicate( vExistingList )
put vNewList
-- [[3, 3, 3], [3, 3, 3]]

vNewList[1][1] = 99
put vNewList
-- [[99, 3, 3], [3, 3, 3]]
put vExistingList
-- [[3, 3, 3], [3, 3, 3]]
-- Note that even the two elements of vNewList were duplicated indepently.

See also

• list()