[Reference] System.SysUtils.FindFirst

System.SysUtils.FindFirst

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. symbolic 링크 파일 유형 만 지정합니다.
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 ++ (faReadOnly | faHidden)을 Attr 매개 변수로 전달하십시오.

일반 파일만 포함 시키려면 Attr 매개 변수에 0을 전달하십시오.

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

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

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

 

Example

var   Str: string;   Num, Code: Integer;   var   FilePath: string;   SearchRec: TSearchRec;   begin   // 파일 존재. '결과: 0, 파일 이름: test.txt'   FilePath := 'H:\Develop\test\Reference\System.SysUtils.FindFirst\test.txt';   Writeln(IntToStr(FindFirst(FilePath, faNormal, SearchRec)) + ', 파일 이름: ' + SearchRec.Name);     // 파일 없음. '결과: 2, 파일 이름: test.txt' ※ SearchRec에 새로운 정보가 저장되지 않음   FilePath := '45ㅛ456ㅎ45ㅛㅎㅅ45ㅛㅎ4f3fed';   Writeln(IntToStr(FindFirst(FilePath, faNormal, SearchRec)) + ', 파일 이름: ' + SearchRec.Name);     Readln; end.

 

given 미국·영국 [|gɪvn]  1. (이미) 정해진 2. 특정한 3. …을 고려해 볼 때 implied 미국·영국 [impláid]  1. 함축된, 은연중의, 암시적인, 언외의(opp. express) 2. 상정상(想定上)의 in addition (to somebody/something) (~에) 덧붙여, 게다가 in addition 게다가 in addition to  …에 더하여, …일 뿐 아니라 archived file 미국·영국 [ɑ́:rkaivd-]  일정 기간 보존 대상 파일 combined 미국·영국 [kəmbáind]  1. 결합된, 합동의, 연합의 2. 화합한 combine 미국식 동사 [kəm|baɪn]  명사 [美|kɑ:mbaɪn]  1. (하나의 단일체를 만들도록) 결합하다 2. (두 가지 이상의 자질・특징 등을) 갖추다 3. (두 가지 이상의 일을) 병행하다

 

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