Difference between revisions of "TStringList"
From Free Pascal wiki
Jump to navigationJump to search| Line 1: | Line 1: | ||
{{TStringList}} | {{TStringList}} | ||
| − | A '''TStringList''' is a datatype that can hold an arbitrary length list of [[String|strings]]. The strings in a TStringList are accessible as concatenated plain text or as a series of strings. Functionality is also provided for key-value pair access. | + | A '''TStringList''' is a [[Data type|datatype]] that can hold an arbitrary length list of [[String|strings]]. The strings in a TStringList are accessible as concatenated plain text or as a series of strings. Functionality is also provided for key-value pair access. |
;Inheritance | ;Inheritance | ||
| − | *[[TObject]] - Base class of all classes. | + | *[[TObject]] - Base [[Class|class]] of all classes. |
**[[TPersistent]], [[IFPObserved]] - Base class for streaming system and persistent properties - Interface implemented by an object that can be observed. | **[[TPersistent]], [[IFPObserved]] - Base class for streaming system and persistent properties - Interface implemented by an object that can be observed. | ||
***[[TStrings]] - Class to manage arrays or collections of strings | ***[[TStrings]] - Class to manage arrays or collections of strings | ||
****'''TStringList''' - Standard implementation of the TStrings class. | ****'''TStringList''' - Standard implementation of the TStrings class. | ||
| − | TStringList adds sorting functionality to [[TStrings]] by adding properties <tt>Sorted</tt>, <tt>Duplicates</tt> and <tt>CaseSensitive</tt> and methods like <tt>Find</tt> to facilitate speeded search within a list. | + | TStringList adds sorting functionality to [[TStrings]] by adding properties <tt>Sorted</tt>, <tt>Duplicates</tt> and [[case-sensitive|<tt>CaseSensitive</tt>]] and [[Method|methods]] like <tt>Find</tt> to facilitate speeded search within a list. |
;Example | ;Example | ||
| − | <syntaxhighlight> | + | <syntaxhighlight lang="pascal"> |
// get a value from file FILNAM filled with key=value pairs | // get a value from file FILNAM filled with key=value pairs | ||
function GetValueFromFile( filnam: string, key: string ): string; | function GetValueFromFile( filnam: string, key: string ): string; | ||
Revision as of 15:41, 16 November 2019
│
English (en) │
suomi (fi) │
polski (pl) │
A TStringList is a datatype that can hold an arbitrary length list of strings. The strings in a TStringList are accessible as concatenated plain text or as a series of strings. Functionality is also provided for key-value pair access.
- Inheritance
- TObject - Base class of all classes.
- TPersistent, IFPObserved - Base class for streaming system and persistent properties - Interface implemented by an object that can be observed.
- TStrings - Class to manage arrays or collections of strings
- TStringList - Standard implementation of the TStrings class.
- TStrings - Class to manage arrays or collections of strings
- TPersistent, IFPObserved - Base class for streaming system and persistent properties - Interface implemented by an object that can be observed.
TStringList adds sorting functionality to TStrings by adding properties Sorted, Duplicates and CaseSensitive and methods like Find to facilitate speeded search within a list.
- Example
// get a value from file FILNAM filled with key=value pairs
function GetValueFromFile( filnam: string, key: string ): string;
var
lst: TStringList;
v: String;
begin
lst := TStringList.Create();
lst.CaseSensitive := false;
lst.Duplicates := dupIgnore; // do not add duplicates
lst.Sorted := true;
lst.LoadFromFile( filnam );
v := lst.Values[ key ];
lst.Free();
result := v;
end;
