void = List_RemoveDuplicates(sListVarName)
This macro function is used to remove all the entries of an existing list whose string value is the same (the associated number values are ignored).
Consider the macro code below, which adds some entries to a list, calls List_RemoveDuplicates, and then calls various list functions to get back some information.
List_Clear(sListCountries)
// put some values in the list
List_Add(sListCountries, 'Albania=Albanien', 10133) // item 1
List_Add(sListCountries, 'Albania=Albanien', 10165) // item 2 same as 1
List_Add(sListCountries, 'Algeria=Algerien', 10183) // item 3
List_Add(sListCountries, 'Andorra=Andorra', 10167) // item 4
List_Add(sListCountries, 'Armenia=Armenien', 10180) // item 5
// remove duplicates
List_RemoveDuplicates(sListCountries)
// now get some information back from the list
sResult = List_GetString(sListCountries, 1) // 'Albania=Albanien'
sResult = List_GetString(sListCountries, 2) // 'Algeria=Algerien'
sResult = List_GetString(sListCountries, 3) // 'Andorra=Andorra'
sResult = List_GetString(sListCountries, 4) // 'Armenia=Armenien'
When using lists, don't forget to always use the function List_Create to create your list at the top of the macro, and then the function List_Destroy to destroy it at the end of the macro.
See also: list macro functions.
Topic 178490, last updated on 18-Apr-2020