str = List_Create(sListVarName)

 

This macro function is used to create a new list named sListVarName.

 

➢For the sake of legibility, we recommend that you use a literal for sListVarName parameter, so that the list name is made more visible, in blue, due to syntax highlighting.

 

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(sListCountryNameOverrides)
List_Destroy(sListCountries)

Creation and Destruction of Lists

 

Make sure that any call to the function List_Create is matched by a later call to the function List_Destroy to destroy it at the end of the macro.

 

See also: List_Create_Global List_Clear List_Destroy List_GetName List_GetNumber List_GetString.

 

---

Topic 178340, last updated on 10-Oct-2026