System.Classes.TStringList.Add

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Add(const S: string): Integer; override;

C++

virtual int __fastcall Add(const System::UnicodeString S);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Classes.pas
System.Classes.hpp
System.Classes TStringList

Beschreibung

Fügt einen neuen String in die Liste hinzu.

Mit Add fügen Sie der Liste den String S hinzu. Bei einer sortierten Liste wird der String entsprechend der Sortierreihenfolge eingefügt. Wenn die Liste nicht sortiert ist, wird S an das Ende der Liste angehängt. Add gibt die Position des Eintrags in der Liste zurück, wobei der erste Eintrag den Index 0 hat.

Anmerkung:  Wenn Sie versuchen, den String S durch einen Aufruf von Add zu einer sortierten Liste hinzuzufügen, die diesen String bereits enthält, wird eine EListError-Exception ausgelöst und die Eigenschaft Duplicates auf dupError gesetzt. Wenn Duplicates den Wert dupIgnore hat und versucht wird, ein Duplikat hinzuzufügen, gibt Add den Index des vorhandenen Eintrags zurück.

Siehe auch

Codebeispiele