Mighty: new page

2013-08-23T15:38:31Z

new page

New page

'''function Add(S: string): Integer'''
S: string to be added
Result: [[TStringList.Strings|<nowiki>Strings[]</nowiki>]] index with newly added string

==Description==
This function will add ''S'' to the list. Note that [[TStringList.Duplicates|Duplicates]] affects the function.<br>
If the list is sorted and the string ''S'' is already present in the list and [[TStringList.Duplicates|Duplicates]] is ''dupError'' then an error occurs. <br>
If [[TStringList.Duplicates|Duplicates]] is set to ''dupIgnore'' then the return value is underfined.
<br><br>
If the list is sorted, new strings will not necessarily be added to the end of the list, rather they will be inserted at their alphabetical position.

==Example==
<syntaxhighlight lang="pascal">
var
s: TStringList;

begin
s := File.CreateStringList();
s.Add('b');
s.Add('a');
s.Add('d');
WriteLn(s.Text);
{
b
a
d

}

s.Add('c');
WriteLn(s.Text);
{
b
a
d
c

}

s.Sort;
s.Sorted := TRUE;
// necessary if you want further values to be sorted as well
s.Duplicates := dupIgnore;

WriteLn(s.Text);
{
a
b
c
d

}

s.Add('c'); // this will be ignored (s.Duplicates = dupIgnore)
s.Add('aa');

WriteLn(s.Text);
{
a
aa
b
c
d

}

s.Free;
end.
</syntaxhighlight>

[[Category:TStringList]]

TStringList.Add - Revision history

Mighty: new page