파일 검색 함수 설명

file_find_first 함수는 주어진 마스크와 속성에 맞는 첫 번째 파일의 이름을 반환합니다. 만약 해당 파일이 존재하지 않으면 빈 문자열을 반환합니다. 마스크는 와일드카드를 포함한 경로를 사용할 수 있습니다. 예를 들어, C:\temp\*.doc와 같이 사용할 수 있습니다.

속성은 보고 싶은 추가 파일을 지정하며, 일반 파일은 마스크를 만족할 경우 항상 반환됩니다. 다음 상수를 더하여 원하는 파일 유형을 선택할 수 있습니다. 속성을 추가하고 싶지 않다면 0 또는 fa_none을 사용하세요.

파일 속성 상수

상수 설명
fa_none 파일 속성이 없음
fa_readonly 읽기 전용 파일
fa_hidden 숨김 파일
fa_sysfile 시스템 파일
fa_volumeid 볼륨 ID 파일
fa_directory 디렉토리
fa_archive 아카이브된 파일
속성은 Windows에서만 사용할 수 있으며, 다른 플랫폼에서는 0 또는 fa_none을 사용해야 합니다.

문법

file_find_first(mask, attr);

인수 설명

인수 유형 설명
mask String 검색에 사용할 마스크
attr 파일 속성 상수 찾고자 하는 특정 파일 속성

예제 코드

다음 코드는 지정된 디렉토리가 존재하는지 확인하고, 존재할 경우 읽기 전용 .doc 파일을 찾습니다. 첫 번째 파일을 찾은 후 두 개의 추가 파일을 찾고 파일 검색기를 닫습니다.

if (directory_exists("\User Content")) {
    fileA = file_find_first("/User Content/*.doc", fa_readonly);
    fileB = file_find_next();
    fileC = file_find_next();
    file_find_close();
}

여러 파일 찾기

아래 코드는 빈 배열을 생성하여 발견된 모든 파일 이름을 저장하고, 읽기 전용 .doc 파일을 찾기 시작합니다. 파일 이름이 빈 문자열이 아닐 경우, 배열에 추가하고 다음 파일을 찾습니다. 빈 문자열이 발견될 때까지 반복하며, 마지막에 파일 검색기를 닫습니다.

var files = [];
var file_name = file_find_first("/User Content/*.doc", fa_readonly);
while (file_name != "") {
    array_push(files, file_name);
    file_name = file_find_next();
}
file_find_close();

이 코드는 특정 디렉토리에서 모든 읽기 전용 .doc 파일을 찾아 배열에 저장하는 방법을 보여줍니다.