파일 검색 함수 설명
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
파일을 찾아 배열에 저장하는 방법을 보여줍니다.