void = List_Destroy(sListVarName)

 

This macro function is used to destroy an existing list named sListVarName.

 

IMPORTANT: do not confuse the functions List_Destroy and List_Delete.

 

•List_Destroy destroys (removes from memory) the entire list.

•List_Delete removes a single entry from a list.

 

The macro code below creates 2 lists, works with them, and then destroys them at the end of the macro (this macro is shown in more details here).

sListCountries = List_Create('sListCountries')
sListCountryNameOverrides = List_Create('sListCountryNameOverrides')
//************************************************************
 
// now work with these 2 lists
// ...
// ...
// and at the end
 
//************************************************************
List_Destroy(sListHolidayNameOverrides)
List_Destroy(sListCountries)

See also: List_Create_Global List_Clear List_Destroy List_GetName List_GetNumber List_GetString.

 

---

Topic 178345, last updated on 21-Jun-2025