System.IOUtils.TDirectory.GetFiles
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::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const _di_TFilterPredicate Predicate)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const _di_TFilterPredicate Predicate)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption, const _di_TFilterPredicate Predicate)/* overload */;
static System::DynamicArray<System::UnicodeString> __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 は例外を発生させます。