System.Classes.TStringList.Find

• Übergeordnet: TStringList

Delphi

function Find(const S: string; var Index: Integer): Boolean; virtual;

C++

virtual bool __fastcall Find(const System::UnicodeString S, int &Index);

Eigenschaften

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

Beschreibung

Sucht in einer sortierten Liste den Index eines Strings und gibt an, ob bereits ein String mit diesem Wert vorhanden ist.

Mit Find können Sie ermitteln, an welcher Position einer sortierten Liste der String S eingefügt werden soll. Ist der String S oder ein anderer String, der sich nur bezüglich der Groß-/Kleinschreibung von S unterscheidet (wenn CaseSensitive false ist ), in der Liste bereits vorhanden, gibt Find true zurück. Wird keine Übereinstimmung gefunden, gibt Find false zurück. Die Position, an der S eingefügt werden soll, wird im Parameter Index angegeben. Der Index basiert auf 0, d.h., der erste Eintrag hat den Index 0, der zweite 1 usw.

Hinweis: Verwenden Sie Find nur bei sortierten Listen. Für unsortierte Listen steht Ihnen die Methode IndexOf zur Verfügung.

Tipp: Wird der String S nicht gefunden (daher ist der Rückbagewert von Find False), ist Index auf den ersten String in der Liste gesetzt, der direkt vor oder nach S kommt.

var
  Index: Integer;
  LStringList: TStringList;

begin
  LStringList := TStringList.Create;
  LStringList.Add('first string');
  LStringList.Add('second string');

  LStringList.Find('first string', Index); // Index = 0 because 'first string' is at index 0
  LStringList.Find('third string', Index); // Index = 2 because 'third string' sorts after 'second string'
  LStringList.Find('great string', Index); // Index = 1 because 'great string' would sort after 'first string', if it existed

  LStringList.Free;
end;

Siehe auch

• Duplicates

• IndexOf

• Sorted

• Strings

Codebeispiele

• TStringListAdd (Delphi)
• TStringListAdd (C++)