Shell.run - Revision history

Bomb Bloke at 07:30, 4 April 2014

2014-04-04T07:30:56Z

2014-04-03T06:42:09Z

Notes re parameters.

2013-05-05T01:19:43Z

Changed to use type template, italicized args in context

2012-11-28T18:38:45Z

Moved to CAT:APIFunctions

2012-10-09T03:09:12Z

2012-09-24T02:32:26Z

2012-09-24T02:32:05Z

2012-09-24T02:30:12Z

Updated to use standard Function template

2012-09-24T01:18:12Z

2012-09-24T01:15:52Z

@@ Line 8: / Line 8: @@
 |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"), so use whichever syntax happens to suit you.<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()]]
@@ Line 18: / Line 18: @@
 }}
 {{Example
-|desc=Runs the program "myProgram" with arguments set in "myTable":
+|desc=Runs the program "monitor" along with the other arguments set in "myTable":
 |code= local myTable = {"monitor","left","worm"}

@@ Line 2: / Line 2: @@
 {{Function
 |name=shell.run
-|args= {{type|string}} program [, {{type|string}} args]
+|args= {{type|string}} program [, {{type|string}} args1, {{type|string}} args2, ...]
 |returns={{type|boolean}} success
 |api=shell
 |addon=ComputerCraft
-|desc=Runs ''program'' with optional specified arguments
+|desc=Runs ''program'' with as many specified arguments as are provided.<br><br>
 |examples=
 {{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".
 }}
 }}
 [[Category:API_Functions]]

@@ Line 2: / Line 2: @@
 {{Function
 |name=shell.run
-|args= [[string (type)|string]] program, [[string (type)|string]] args
+|args= {{type|string}} program [, {{type|string}} args]
-|returns=True/False
+|returns={{type|boolean}} success
 |api=shell
 |addon=ComputerCraft
-|desc=Runs the specified program with the specified arguments
+|desc=Runs ''program'' with optional specified arguments
 |examples=
 {{Example

@@ Line 3: / Line 3: @@
 |name=shell.run
 |args= [[string (type)|string]] program, [[string (type)|string]] args
-<!-- |returns=[[Nil|nil]] -->
+|returns=True/False
 |api=shell
 |addon=ComputerCraft

@@ Line 1: / Line 1: @@
 {{Example
-|desc=shell.run(String programLocation, String arguments), This program is used to run a program with code instead of type. such as if you typed "myprogram test".
+|desc=shell.run(String programLocation, String sArgs), This function is used to run a program at the desired location with the sArgs as the           arguments.
-This does not produce a new line, and anything else printed or written after this will be on the same line.
 |code=shell.run("myprogram", "test")
 |output=Runs the program "myprogram" with arguments "test"

← Older revision		Revision as of 01:15, 24 September 2012
Line 1:		Line 1:
−	{{~~stub~~}}	+	{{Example
		+	\|desc=shell.run(String programLocation, String arguments), This program is used to run a program with code instead of type. such as if you typed "myprogram test".
		+	This does not produce a new line, and anything else printed or written after this will be on the same line.
		+	\|code=shell.run("myprogram", "test")
		+	\|output=Runs the program "myprogram" with arguments "test"
		+	}}
		+
		+	Here is a example how to run programs with custom input.
		+
		+	stringArgs=read() -- You input a line of string, and each space makes a argument, such as "arg1 arg2". Argument 1 is "arg1".
		+	shell.run("myprogram", stringArgs)
		+	-- runs the program. myprogram would have to be located on the main directory of the computer for this to work.