Difference between revisions of "Shell.programs"

From ComputerCraft Wiki
Jump to: navigation, search
(Renamed optional argument)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
Shell.programs is a shell command used in the dir command in default CC
+
{{lowercase}}
 +
{{Function
 +
|name=shell.programs
 +
|args=[<nowiki/>{{type|boolean}} showHidden]
 +
|returns={{type|table}} programs
 +
|api=Shell
 +
|addon=ComputerCraft
 +
|desc=Returns a table of files in the current directory and in rom/programs. If ''showHidden'' is true, will also return files that begin with a period (hidden files).
 +
|examples=
 +
{{Example
 +
|desc=The program lists files in the current directory and in rom/programs, not including files that are prefixed with a period (hidden files).
 +
|code=textutils.tabulate(shell.programs())
 +
|output=A tabulated list of programs. This is basically the 'programs' program.
 +
}}
 +
{{Example
 +
|desc=The program lists all files in the current directory and in rom/programs.
 +
|code=textutils.tabulate(shell.programs(true))
 +
|output=A tabulated list of programs. This is basically the 'programs' program, but it shows hidden files too.
 +
}}
 +
}}
  
−
<nowiki>function shell.programs( _bIncludeHidden )
+
[[Category:API_Functions]]
−
local tItems = {}
+
−
+
−
-- Add programs from the path
+
−
    for sPath in string.gmatch(sPath, "[^:]+") do
+
−
    sPath = shell.resolve( sPath )
+
−
if fs.isDir( sPath ) then
+
−
local tList = fs.list( sPath )
+
−
for n,sFile in pairs( tList ) do
+
−
if not fs.isDir( fs.combine( sPath, sFile ) ) and
+
−
  (_bIncludeHidden or string.sub( sFile, 1, 1 ) ~= ".") then
+
−
tItems[ sFile ] = true
+
−
end
+
−
end
+
−
end
+
−
    end
+
−
 
+
−
-- Sort and return
+
−
local tItemList = {}
+
−
for sItem, b in pairs( tItems ) do
+
−
table.insert( tItemList, sItem )
+
−
end
+
−
table.sort( tItemList )
+
−
return tItemList
+
−
end</nowiki>
+

Latest revision as of 19:29, 4 April 2014


Grid Redstone.png  Function shell.programs
Returns a table of files in the current directory and in rom/programs. If showHidden is true, will also return files that begin with a period (hidden files).
Syntax shell.programs([boolean showHidden])
Returns table programs
Part of ComputerCraft
API Shell

Examples

Grid paper.png  Example
The program lists files in the current directory and in rom/programs, not including files that are prefixed with a period (hidden files).
Code 
textutils.tabulate(shell.programs())
Output A tabulated list of programs. This is basically the 'programs' program.



Grid paper.png  Example
The program lists all files in the current directory and in rom/programs.
Code 
textutils.tabulate(shell.programs(true))
Output A tabulated list of programs. This is basically the 'programs' program, but it shows hidden files too.
Retrieved from "https://www.computercraft.info/wiki/index.php?title=Shell.programs&oldid=6345"