System.IOUtils.TDirectory.GetDirectories

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

class function GetDirectories(const Path: string): TStringDynArray;
class function GetDirectories(const Path: string;
const Predicate: TFilterPredicate): TStringDynArray;
class function GetDirectories(const Path,
SearchPattern: string): TStringDynArray; overload; inline; static;
class function GetDirectories(const Path, SearchPattern: string;
const Predicate: TFilterPredicate): TStringDynArray;
class function GetDirectories(const Path, SearchPattern: string;
const SearchOption: TSearchOption): TStringDynArray; overload; static;
class function GetDirectories(const Path, SearchPattern: string;
const SearchOption: TSearchOption;
const Predicate: TFilterPredicate): TStringDynArray; overload; static;
class function GetDirectories(const Path: string;
const SearchOption: TSearchOption;
const Predicate: TFilterPredicate): TStringDynArray; overload; static;

C++

static System::TStringDynArray __fastcall GetDirectories(const System::UnicodeString Path)/* overload */;
static System::TStringDynArray __fastcall GetDirectories(const System::UnicodeString Path, const _di_TFilterPredicate Predicate)/* overload */;
static System::TStringDynArray __fastcall GetDirectories(const System::UnicodeString Path, const System::UnicodeString SearchPattern)/* overload */;
static System::TStringDynArray __fastcall GetDirectories(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const _di_TFilterPredicate Predicate)/* overload */;
static System::TStringDynArray __fastcall GetDirectories(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption)/* overload */;
static System::TStringDynArray __fastcall GetDirectories(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption, const _di_TFilterPredicate Predicate)/* overload */;
static System::TStringDynArray __fastcall GetDirectories(const System::UnicodeString Path, const TSearchOption SearchOption, const _di_TFilterPredicate Predicate)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.IOUtils.pas
System.IOUtils.hpp
System.IOUtils TDirectory

Beschreibung

Gibt eine Liste der Unterverzeichnisse im angegebenen Verzeichnis zurück.

Mit GetDirectories können Sie eine Liste der Unterverzeichnisse abrufen, die im angegebenen Verzeichnis enthalten sind. GetDirectories gibt ein dynamisches Array mit Strings zurück, in dem jedes Element dem Namen eines Unterverzeichnisses entspricht.

GetDirectories liegt in drei Syntaxvarianten vor:

  • Die erste Variante übernimmt als Parameter nur den Pfad des Verzeichnisses, dessen Unterverzeichnisse aufgelistet werden sollen.
  • Bei der zweiten Variante wird ein Suchmuster für Unterverzeichnisnamen angegeben.
  • Bei der dritten Variante wird mit einer Option angegeben, ob bei der Auflistung der rekursive Modus verwendet wird.

Alle Varianten akzeptieren den optionalen Parameter TFilterPredicate zum Filtern der Ergebnisse.

Die folgende Tabelle enthält die von dieser Methode erwarteten Parameter.



Name Bedeutung

Path

Der Pfad des Verzeichnisses, dessen Unterverzeichnisse aufgelistet werden sollen.

SearchPattern

Die Maske für die Suche nach Verzeichnisnamen (z. B. werden mit "*app" alle Verzeichnisse berücksichtigt, die mit "app" enden).

SearchOption

Der Auflistungsmodus für das Verzeichnis. Er legt fest, ob die Auflistung nur für die oberste Ebene oder rekursiv erfolgt.

Predicate

Eine Routine, mit der unerwünschte Ergebnisse herausgefiltert werden können.



Anmerkung:  GetDirectories löst eine Exception aus, wenn der angegebene Pfad ungültig oder das Verzeichnis nicht vorhanden ist.

Siehe auch

Codebeispiele