디렉터리의 모든 파일 이름 목록 가져오기 (file.list)

선언

파일 목록, 오류 정보 = file.list(파일 경로 [, 전체 하위 탐색])

매개변수

• 파일 경로
  문자열. 디렉터리의 절대 경로입니다.
• 전체 하위 탐색(20250313 버전부터 지원)
  불리언, 선택 사항. 하위 디렉터리를 재귀 탐색하여 전체 경로 목록을 반환할지 여부이며 기본값은 false입니다.

반환값

• 파일 목록
  순서 테이블 또는 nil. 디렉터리가 없거나 경로가 파일이면 nil, 그렇지 않으면 디렉터리의 파일 목록을 반환합니다.
• 오류 정보
  문자열. 작업 실패 시의 오류 정보입니다.

설명

디렉터리의 모든 파일 이름 목록을 가져옵니다.

예제

local list, err = file.list("/var/mobile/")
if list then
    print("目录 `/var/mobile/` 中有"..#list.."个文件或目录")
    for _, name in ipairs(list) do
        print(name)
    end
    sys.alert(print.out())
else
    sys.alert("`/var/mobile/` 不是目录："..err)
end

참고: 위 코드에서는 이 장에서 설명하지 않는 함수인 sys.alert를 사용합니다.

전체 하위 탐색 예제

-- 전체 파일 경로 목록 = file.list(파일 경로, 전체 하위 탐색)
-- 디렉터리의 파일 이름 목록을 가져옴. 두 번째 인수는 하위 디렉터리 파일의 전체 경로 목록을 재귀적으로 가져올지 제어하며 기본값은 false
list = file.list("/var/mobile/Media/1ferver", true)
nLog(list)
--[[
가능한 출력
{ -- table: 0xc4cc58a30
    [1] = "/var/mobile/Media/1ferver/snippets/syntax - do __ end.snippet",
    [2] = "/var/mobile/Media/1ferver/snippets/app - app.uninstall(bid).snippet",
    [3] = "/var/mobile/Media/1ferver/snippets/test - snippet.snippet",
    ...
}
--]]

참고: 위 코드에서는 이 장에서 설명하지 않는 함수인 nLog를 사용합니다.