Difference between revisions of "Shell.run"

From ComputerCraft Wiki
Jump to: navigation, search
m
 
(3 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
{{Function
 
{{Function
 
|name=shell.run
 
|name=shell.run
|args= [[string (type)|string]] program, [[string (type)|string]] args
+
|args= {{type|string}} program [, {{type|string}} args1, {{type|string}} args2, ...]
|returns=True/False
+
|returns={{type|boolean}} success
 
|api=shell
 
|api=shell
 
|addon=ComputerCraft
 
|addon=ComputerCraft
|desc=Runs the specified program with the specified arguments
+
|desc=Runs ''program'' with as many specified arguments as are provided.<br><br>
 +
 
 +
Essentially takes all parameters passed to it and runs them as one line - for eg, shell.run("monitor","top","alongtimeago") is the same as shell.run("monitor top alongtimeago"), and you can use whichever syntax happens to suit you.<br><br>
 +
 
 +
See also: [[shell.openTab|shell.openTab()]]
 
|examples=
 
|examples=
 
{{Example
 
{{Example
|desc=Runs the program "myprogram" with arguments "test" and "ing"
+
|desc=Runs the program "myProgram" with arguments "test" and "ing":
|code=shell.run("myprogram", "test", "ing")
+
|code= shell.run("myProgram", "test", "ing")
|output=The program myprogram with the arguments "test" and "ing"
+
|output=The program myProgram with the arguments "test" and "ing".
 +
}}
 +
{{Example
 +
|desc=Runs the program "monitor" along with the other arguments set in "myTable":
 +
|code= local myTable = {"monitor","left","worm"}
 +
 +
shell.run( unpack(myTable) )
 
}}
 
}}
 
}}
 
}}
 +
 +
[[Category:API_Functions]]

Latest revision as of 07:30, 4 April 2014


Grid Redstone.png  Function shell.run
Runs program with as many specified arguments as are provided.

Essentially takes all parameters passed to it and runs them as one line - for eg, shell.run("monitor","top","alongtimeago") is the same as shell.run("monitor top alongtimeago"), and you can use whichever syntax happens to suit you.

See also: shell.openTab()
Syntax shell.run(string program [, string args1, string args2, ...])
Returns boolean success
Part of ComputerCraft
API shell

Examples

Grid paper.png  Example
Runs the program "myProgram" with arguments "test" and "ing":
Code
shell.run("myProgram", "test", "ing")
Output The program myProgram with the arguments "test" and "ing".



Grid paper.png  Example
Runs the program "monitor" along with the other arguments set in "myTable":
Code
local myTable = {"monitor","left","worm"}

shell.run( unpack(myTable) )