[Reference] System.SysUtils.FindFirst

System.SysUtils.FindFirst

Up to Parent: System.SysUtils

Delphi

function FindFirst(const Path: string; Attr: Integer; var F: TSearchRec): Integer;

C++

extern PACKAGE int __fastcall FindFirst(const System::UnicodeString Path, int Attr, TSearchRec &F);

Properties

Type	Visibility	Source	Unit	Parent
function	public	System.SysUtils.pas System.SysUtils.hpp	System.SysUtils	System.SysUtils

Description

Searches for the first instance of a file name / with a given set of attributes / in a specified directory.

FindFirst / searches the directory specified by Path / for the first file that matches / the file name implied by Path and the attributes specified by the Attr parameter.

The result is returned in the F parameter.

Use the fields of this search record / to extract the needed information. 

FindFirst returns 0 if a file was successfully located, / otherwise, it returns an error code.

The Path constant parameter / is the directory and file name mask, including wildcard characters.

For example, '.\test\*.*' specifies all files in the test subdirectory (on Windows).

The Attr parameter / specifies the special files to include in addition to all normal files.

Choose from these file attribute constants / when specifying the Attr parameter.

 

지정된 디렉토리에서 주어진 속성 세트를 사용하여 파일 이름의 첫 번째 인스턴스를 검색합니다.

FindFirst는 Path에 의해 암시된 파일 이름과 Attr 파라미터로 지정된 속성과 일치하는 첫 번째 파일에 대해 Path에 의해 지정된 디렉토리를 검색합니다.

결과는 F 파라미터로 리턴됩니다.

이 검색 레코드의 필드를 사용하여 필요한 정보를 추출합니다.

파일을 성공적으로 찾으면 FindFirst는 0을 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

Path 상수 파라미터는 와일드 카드 문자를 포함하는 디렉토리 및 파일 이름 마스크입니다.

※ 파일을 지정할 때, 구체적인 이름 대신에 여러 파일을 동시에 지정할 목적으로 사용하는 특수 기호. `＊', `？' 따위.

예를 들어, '. \ test \ *. *'는 test 서브 디렉토리의 모든 파일을 지정합니다 (Windows의 경우).

Attr 파라미터는 모든 일반 파일 외에도 포함할 특수 파일을 지정합니다.

Attr 파라미터를 지정할 때 파일 속성 상수 중에서 선택합니다.

 

Constant	Description	설명
faInvalid	Identifies an invalid file.	유효하지 않은 파일을 식별합니다.
faReadOnly	Identifies read-only files or directories.	읽기 전용 파일 또는 디렉토리를 식별합니다.
faHidden	Identifies hidden files or directories.	숨겨진 파일 또는 디렉토리를 식별합니다.
faSysFile	Identifies system files or directories.	시스템 파일 또는 디렉토리를 식별합니다.
faVolumeID	Deprecated	더 이상 사용되지 않는
faDirectory	Identifies a directory.	디렉토리를 식별합니다.
faArchive	Identifies Windows archived files.	Windows 보관 파일을 식별합니다.
faNormal	Identifies normal files.	일반 파일을 식별합니다.
faTemporary	Identifies temporary files or directories.	임시 파일 또는 디렉토리를 식별합니다.
faSymLink	Specifies only symbolic link file types.	기호 링크 파일 유형만 지정합니다.
faCompressed	Identifies a compressed file or directory.	압축된 파일 또는 디렉토리를 식별합니다.
faEncrypted	Identifies an encrypted file or directory.	암호화 된 파일 또는 디렉토리를 식별합니다.
faVirtual	Reserved for system use.	시스템 용도로 예약되어 있습니다.
faAnyFile	Specifies any file type.	모든 파일 형식을 지정합니다.

Attributes / can be combined by adding (Delphi) or or-ing (C++) their constants or values.

For example, to search for read-only and hidden files in addition to normal files, / pass (faReadOnly + faHidden) in Delphi or (faReadOnly | faHidden) in C++ as the Attr parameter.

To include only normal files, / pass zero for the Attr parameter.

Note: FindFirst / allocates resources (memory) that must be released by calling FindClose.

Note: Some of the file attribute constants / are not valid on all platforms.

For example, faVolumeID and faArchive do not work on MAC OS.

 

속성은 상수 또는 값을 (델파이) 또는 (C ++)으로 추가하여 결합할 수 있습니다.

예를 들어, 일반 파일 외에도 읽기 전용 파일과 숨김 파일을 검색하려면, Delphi에서는 (faReadOnly + faHidden)을 (를) 또는 C ++의 Attr  파라미터로 (faReadOnly | faHidden)를 전달합니다.

일반 파일만 포함 시키려면 Attr 파라미터에 0을 전달합니다.

참고 : FindFirst는 FindClose를 호출하여 해제해야 하는 리소스 (메모리)를 할당합니다.

참고 : 파일 속성 상수 중 일부는 모든 플랫폼에서 유효하지 않습니다.

예를 들어, faVolumeID 및 FaArchive는 MAC OS에서 작동하지 않습니다.

 

implied 미국·영국 [impláid]  1. 함축된, 은연중의, 암시적인, 언외의(opp. express)   2. 상정상(想定上)의 in addition to  …에 더하여, …일 뿐 아니라

 

출처: http://docwiki.embarcadero.com/Libraries/XE2/en/System.SysUtils.FindFirst