LIST.Create |
![]() ![]() |
lid = LIST.Create( item_1-name AS STRING, item_1-type AS TYPE, [item_2-name AS STRING, item_2-type AS TYPE, . . item_n-name AS STRING, item_n-type AS TYPE,] initial-size AS INTEGER [=0] ) AS HANDLE
Creates a new List with the specified item types. Each item can then be accessed by name or index (itx). A List Element must have at least one Item. Memory allocated for strings are freed when the list is deleted. Any memory that has been allocated to a REFERENCE must be freed by the caller. The function returns a handle to the List or LS_Fail
The Element Items can be of any of the following MyBASIC2 types:
INTEGER REAL STRING REFERENCE HANDLE MODULE
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 )
|