Difference between revisions of "love.filesystem.enumerate"

m (In 0.8.0, testing showed that the enumerate function is not relative to the .love archive but to the save dir! This cost me quite a few hours ...)
(The filesystem module never takes absolute paths, but this function should return the files from both places. If you're experiencing something else, please submit a test case to the issue tracker.)
Line 1: Line 1:
Returns a table with the names of files and subdirectories in the directory in an undefined order.
+
Returns a table with the names of files and subdirectories in the specified path. The table is not sorted in anyway; the order is undefined.
  
Note that this directory is relative to the save directory (see [[love.filesystem.getSaveDirectory]]) of the game being run. Absolute paths will not work.
+
If the path passed to the function exists in the game and the save directory, it will list the files and directories from both places.
  
 
== Function ==
 
== Function ==

Revision as of 04:57, 27 February 2013

Returns a table with the names of files and subdirectories in the specified path. The table is not sorted in anyway; the order is undefined.

If the path passed to the function exists in the game and the save directory, it will list the files and directories from both places.

Function

Synopsis

files = love.filesystem.enumerate( dir )

Arguments

string dir
The directory.

Returns

table files
A sequence with the names of all files and subdirectories as strings.

Examples

Simple Example

local dir = ""
--assuming that our path is full of lovely files (it should at least contain main.lua in this case)
local files = love.filesystem.enumerate(dir)
for k, file in ipairs(files) do
	print(k .. ". " .. file) --outputs something like "1. main.lua"
end

Recursively find and display all files and folders in a folder and its subfolders.

function love.load()
	filesString = recursiveEnumerate("", "")
end

-- This function will return a string filetree of all files
-- in the folder and files in all subfolders
function recursiveEnumerate(folder, fileTree)
	local lfs = love.filesystem
	local filesTable = lfs.enumerate(folder)
	for i,v in ipairs(filesTable) do
		local file = folder.."/"..v
		if lfs.isFile(file) then
			fileTree = fileTree.."\n"..file
		elseif lfs.isDirectory(file) then
			fileTree = fileTree.."\n"..file.." (DIR)"
			fileTree = recursiveEnumerate(file, fileTree)
		end
	end
	return fileTree
end
	
function love.draw()
	love.graphics.print(filesString, 0, 0)
end

See Also


Other Languages