Lua:Class:Stringlist

{} Class

class Stringlist : Strings

The Stringlist class represents a mutable list of strings.

It inherits from Strings and adds sorting, duplicate handling, and case-sensitivity behavior.

Inheritance

Class	Inherits From	Description
Stringlist	Strings	A string list object with sorting and duplicate handling options.
Strings	Object	Base class for string collection objects.

Creation

<> Lua API Reference

function createStringlist() : Stringlist

Creates a Stringlist class object.

Function Parameters

This function has no parameters.

Returns

Stringlist — The created Stringlist object.

Properties

Property	Type	Description
Sorted	Boolean	Determines if the list should be sorted.
Duplicates	DuplicatesType	Determines how duplicates should be handled when the list is sorted.
CaseSensitive	Boolean	Determines if the list is case sensitive.

DuplicatesType

Constant	Value	Description
dupIgnore	0	Ignores duplicate values.
dupAccept	1	Accepts duplicate values.
dupError	2	Raises an error when a duplicate value is added.

Methods

Method	Return Type	Description
getDuplicates()	DuplicatesType	Returns the Duplicates property.
setDuplicates(Duplicates)	void	Sets the Duplicates property. Valid values are dupIgnore, dupAccept, and dupError.
getSorted()	Boolean	Returns true if the Sorted property is enabled.
setSorted(boolean)	void	Sets the Sorted property.
getCaseSensitive()	Boolean	Returns true if the CaseSensitive property is enabled.
setCaseSensitive(boolean)	void	Sets the CaseSensitive property.

Examples

 1 local list = createStringlist()
 2 
 3 list.add("Banana")
 4 list.add("Apple")
 5 list.add("Cherry")
 6 
 7 list.Sorted = true
 8 
 9 for i = 0, list.Count - 1 do
10   print(list[i])
11 end
12 
13 list.destroy()

 1 local list = createStringlist()
 2 
 3 list.Sorted = true
 4 list.Duplicates = dupIgnore
 5 
 6 list.add("Apple")
 7 list.add("Apple")
 8 list.add("Banana")
 9 
10 for i = 0, list.Count - 1 do
11   print(list[i])
12 end
13 
14 list.destroy()

 1 local list = createStringlist()
 2 
 3 list.CaseSensitive = false
 4 list.Sorted = true
 5 list.Duplicates = dupError
 6 
 7 list.add("Apple")
 8 
 9 local success, err = pcall(function()
10   list.add("apple")
11 end)
12 
13 if not success then
14   print("Duplicate error: " .. tostring(err))
15 end
16 
17 list.destroy()

Main Pages

Core Lua documentation entry points

◆ Lua
◆ Script Engine