LIST.Append

new-size = LIST.Append( dst-lid AS HANDLE,

                        src-lid AS HANDLE ) AS INTEGER

Appends one list to another creating a List with the contents of both lists.  The size of the concatenated list is returned if successfully appended.

Example:

DIM hList AS HANDLE

hList = LIST.Create( "Kalle", STRING, "Nisse", REAL )

LIST.Insert( hList )

LIST.Insert( hList )

LIST.Insert( hList, LS_FRONT )

LIST.Insert( hList, 1 )

LIST.At( hList, 0, 0, "Kalle Anka      " )

LIST.At( hList, 0, 1, 1.234 )

LIST.At( hList, 1, 0, "Kajsa Anka      " )

LIST.At( hList, 1, 1, 2.345 )

LIST.At( hList, 2, 0, "Joakim von Anka " )

LIST.At( hList, 2, 1, 3.456 )

LIST.At( hList, 3, 0, "Farmor Anka     " )

LIST.At( hList, 3, 1, 4.567 )

DIM hList2 AS HANDLE

hList2 = LIST.Create( "Kalle", STRING, "Nisse", REAL, 4 )

LIST.At( hList2, 0, "Kalle", "ShitHouse       " )

LIST.At( hList2, 0, "Nisse", 101.101 )

LIST.At( hList2, 1, "Kalle", "SheissHouse     " )

LIST.At( hList2, 1, "Nisse", 202.202 )

LIST.At( hList2, 2, "Kalle", "SkitHus         " )

LIST.At( hList2, 2, "Nisse", 303.303 )

LIST.At( hList2, 3, "Kalle", "PoopStation     " )

LIST.At( hList2, 3, "Nisse", 404.404 )

' Append the 2 Lists

LIST.Append( hList, hList2 )