Difference between revisions of "Fs.list"

From ComputerCraft Wiki
Jump to: navigation, search
(Clarify description of return value)
(Clarify that subdirectories’ contents are not returned)
Line 5: Line 5:
 
|api=fs
 
|api=fs
 
|returns=[[table (type)|table]] list of files and folders in <var>path</var>, which must be a directory
 
|returns=[[table (type)|table]] list of files and folders in <var>path</var>, which must be a directory
|desc=Returns a list of all the files (including subdirectories) contained in a directory, as a numerically indexed table.
+
|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

Revision as of 19:18, 22 April 2013


Grid Redstone.png  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, which must be a directory
Part of ComputerCraft
API fs

Examples

Grid paper.png  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().