function transforms a list of alternating (
) pairs in
is supplied it is modified to contain the result and must be a list the same length as
is not supplied, a new list is returned.
CAPI Reference Manual - 15 Dec 2011