Difference between revisions of "Shell.run"

Latest revision as of 07:30, 4 April 2014

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

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".

Example
Runs the program "monitor" along with the other arguments set in "myTable":
Code	local myTable = {"monitor","left","worm"} shell.run( unpack(myTable) )

@@ Line 1: / Line 1: @@
-if true do
+{{lowercase}}
- --code here
+{{Function
-end
+|name=shell.run
+|args= {{type|string}} program [, {{type|string}} args1, {{type|string}} args2, ...]
+|returns={{type|boolean}} success
+|api=shell
+|addon=ComputerCraft
+|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=
+{{Example
+|desc=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".
+}}
+{{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]]