System.IOUtils.TDirectory.GetFiles

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

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

C++

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

プロパティ

種類 可視性 ソース ユニット
function public
System.IOUtils.pas
System.IOUtils.hpp
System.IOUtils TDirectory


説明

指定のディレクトリ内のファイルのリストを返します。

GetFiles を使用すると、指定されたディレクトリにあるファイルのリストを取得することができます。GetFiles の戻り値は、文字列の動的配列で、その内部の各要素には、ファイルの名前がパスと共に格納されています。

GetFiles メソッドには、以下の 3 つの形式があります。

  • 1 番目の形式は、ファイルを列挙したいディレクトリのパスのみを受理します。
  • 2 番目の形式には、ファイル名に一致する検索パターンが含まれています。
  • 3 番目の形式には、列挙する際に再帰モードを使用するかどうかを指定するオプションが含まれています。

どの形式も、結果をフィルタリングするために使われる TFilterPredicate オプション パラメータを受理します。

The following table lists the parameters expected by this method.

名前 意味

Path

ファイルを列挙しようとするディレイクトリのパス。

SearchPattern

ファイル名との一致に使用するマスク(たとえば、"*.exe" はすべての実行可能ファイルと一致します)。 SearchPattern 引数を適用している場合には、MatchesMask も使用できます。

SearchOption

ディレクトリの列挙モード。 トップレベル列挙モードを使用するか、再帰列挙モードを使用するかを指定します。

Predicate

望まない結果を除去するために使われるルーチン。


メモ: 指定のパスが無効であるか、またはそのディレクトリが存在しない場合、GetFiles は例外を発生させます。

関連項目

Code Examples