Difference between revisions of "Fs.list"
From ComputerCraft Wiki
m (Moved to CAT:LuaCoreFunctions) |
(Update description to correct semantics for non-directories and use type template) |
||
| (5 intermediate revisions by 4 users not shown) | |||
| Line 2: | Line 2: | ||
{{Function | {{Function | ||
|name=fs.list | |name=fs.list | ||
| − | |args= | + | |args={{Type|string}} path |
|api=fs | |api=fs | ||
| − | |returns= | + | |returns={{Type|table}} list of files and folders in <var>path</var>. If <var>path</var> is not a directory, an empty table is returned. |
| − | |desc=Returns a list of all the files contained in a directory, | + | |desc=Returns a list of all the files (including subdirectories but not their contents) contained in a directory, as a numerically indexed table. |
|examples= | |examples= | ||
{{Example | {{Example | ||
| Line 11: | Line 11: | ||
|code=local FileList = fs.list("") --Table with all the files and directories available | |code=local FileList = fs.list("") --Table with all the files and directories available | ||
| − | for _,file in ipairs( FileList ) do --Loop. Underscore because we don't use the key, ipairs so it's in order | + | for _, file in ipairs(FileList) do --Loop. Underscore because we don't use the key, ipairs so it's in order |
| − | print( file ) --Print the file name | + | print(file) --Print the file name |
end --End the loop | end --End the loop | ||
| − | |output=A list of all files and folders in the root directory as a table. Note that fs.list() could also be inserted directly into ipairs() or pairs() | + | |output=A list of all files and folders in the root directory as a table. Note that fs.list() could also be inserted directly into ipairs() or pairs(). |
}} | }} | ||
}} | }} | ||
[[Category:Lua_Core_Functions]] | [[Category:Lua_Core_Functions]] | ||
Latest revision as of 19:43, 22 April 2013
 Function fs.list | |
| Returns a list of all the files (including subdirectories but not their contents) contained in a directory, as a numerically indexed table. | |
| Syntax | fs.list(string path) |
| Returns | table list of files and folders in path. If path is not a directory, an empty table is returned. |
| Part of | ComputerCraft |
| API | fs |
Examples
 Example | |
| Displays a list of all files and folders in the root directory of a computer | |
| Code |
local FileList = fs.list("") --Table with all the files and directories available
for _, file in ipairs(FileList) do --Loop. Underscore because we don't use the key, ipairs so it's in order
print(file) --Print the file name
end --End the loop
|
| Output | A list of all files and folders in the root directory as a table. Note that fs.list() could also be inserted directly into ipairs() or pairs(). |
