LIST.Delete

new-size = LIST.Delete( lid AS HANDLE ) AS INTEGER

Deletes (removes) all List Elements from the list and frees any memory allocated by the list.  Returns the new size.  This should be 0 if successful.

Example:

DIM hList AS HANDLE

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

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 )

' Delete and Close the List

LIST.Delete( hList )

LIST.Close( hList )

END