TStringList class

In unit Classes

Standard implementation of the TStrings class.

Declaration

pascal

TStringList = class(TStrings)

Inheritance

TStringList
TStrings
TPersistent
TObject

Descends from it: TCoffStringTable TExtendedStringList THashedStringList TLookupStringList TParseStringList TShortCutList TStringListUTF8Fast TValueListStrings

Description

TStringList is a descendant class of TStrings that implements all of the abstract methods introduced there. It also introduces some additional methods:

Sort the list, or keep the list sorted at all times
Special handling of duplicates in sorted lists
Notification of changes in the list

Properties

`Duplicates`	public	Describes the behaviour of a sorted list with respect to duplicate strings.
`Sorted`	public	Determines whether the list is sorted or not.
`CaseSensitive`	public	Indicates whether comparing strings happens in a case sensitive manner.
`OwnsObjects`	public	Determines whether the stringlist owns it's objects or not.
`SortStyle`	public	Sort style for strings.

Methods

`CheckIndex`	protected
`ExchangeItems`	protected
`Changed`	protected	Called when the list of strings was modified.
`Changing`	protected	Called when the list is changing.
`Get`	protected	Overrides the standard read handler for the property.
`GetCapacity`	protected	Overrides the standard read handler for the property.
`GetCount`	protected	Overrides the standard read handler for the property.
`GetObject`	protected	Overrides the standard read handler for the property.
`Put`	protected	Overrides the standard write handler for the property.
`PutObject`	protected	Overrides the standard write handler for the property.
`SetCapacity`	protected	Overrides the standard write handler for the property.
`SetUpdateState`	protected	Overrides the standard call.
`InsertItem`	protected
`DoCompareText`	protected
`DoAddObject`	protected
`Create`	public	Initializ a new TStrings instance.
`Destroy`	public	Destroys the stringlist.
`Add`	public	Implements the function.
`AddObject`	public	Add a string and associated object to the list.
`Clear`	public	Implements the function.
`Delete`	public	Implements the function.
`Exchange`	public	Implements the function.
`Find`	public	Locates the index for a given string in sorted lists.
`IndexOf`	public	Overrides the property.
`Insert`	public	Overrides the method.
`Sort`	public	Sorts the strings in the list.
`CustomSort`	public	Sort the stringlist using a custom sort algorithm.

Events

`OnChange`	public	Event triggered after the list was modified.
`OnChanging`	public	Event triggered when the list is about to be modified.

Inherited

From TStrings (78)

AddCommaText AddDelimitedtext AddPair AddStrings AddText AlwaysQuote Append Assign BeginUpdate Capacity CheckSpecialChars CommaText CompareStrings Contains ContainsName ContainsObject Count DefaultEncoding DefineProperties DelimitedText Delimiter Encoding EndUpdate Equals Error ExtractName Fill Filter ForEach GetDelimitedText GetEnumerator GetNameValue GetNextLine GetNextLinebreak GetText GetTextStr GetValueFromIndex IndexOfName IndexOfObject InsertObject LastIndexOf LineBreak LoadFromFile LoadFromStream Map MissingNameValueSeparatorAction Move Names NameValueSeparator Objects Options Pop QuoteChar Reduce Reverse SaveToFile SaveToStream SetDelimitedText SetStrings SetText SetTextStr SetValueFromIndex Shift SkipLastLineBreak Slice StrictDelimiter Strings StringsAdapter Text TextLineBreakStyle ToObjectArray ToStringArray TrailingLineBreak UpdateCount UseLocale ValueFromIndex Values WriteBOM

From TPersistent (6)

AssignTo FPOAttachObserver FPODetachObserver FPONotifyObservers GetNamePath GetOwner

From TObject (39)

AfterConstruction BeforeDestruction CheckDisposed ClassInfo ClassName ClassNameIs ClassParent ClassType CleanupInstance DefaultHandler DefaultHandlerStr Dispatch DispatchStr Disposed DisposeOf FieldAddress Free FreeInstance GetDisposed GetHashCode GetInterface GetInterfaceByStr GetInterfaceEntry GetInterfaceEntryByStr GetInterfaceTable GetInterfaceWeak GetLastCastErrorInfo InheritsFrom InitInstance InstanceSize MethodAddress MethodName newinstance QualifiedClassName SafeCallException StringMessageTable SystemHasExtendedRTTI ToString UnitName

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.