Difference between revisions of "Shell (API)"
From ComputerCraft Wiki
Bomb Bloke (Talk | contribs) (Wiki table.) |
MKlegoman357 (Talk | contribs) (Added CC version in the note) |
||
| Line 68: | Line 68: | ||
|} | |} | ||
| − | Note that [[shell.run]] and [[shell.openTab]] concatenate any arguments they are given (with single space separator characters) before parsing the command, and as of ComputerCraft version | + | Note that [[shell.run]] and [[shell.openTab]] concatenate any arguments they are given (with single space separator characters) before parsing the command, and as of ComputerCraft version 1.45, now also support a single string containing ''all'' parameters. |
[[Category:APIs]] | [[Category:APIs]] | ||
Revision as of 19:17, 4 April 2014
The shell API allows you to interface with the shell.
API
| Returns | Method name | Description |
|---|---|---|
| shell.exit() | Exits the current shell. | |
| string directory | shell.dir() | Returns the directory. |
| shell.setDir(string path) | Sets the directory. | |
| string path | shell.path() | Returns the path. |
| shell.setPath(string path) | Sets the path. | |
| string path | shell.resolve(string localpath) | Resolves a local path to an absolute path. |
| string path | shell.resolveProgram(string name) | Resolves the absolute path to the program whose name you provided. |
| table aliases | shell.aliases() | Returns aliases. |
| shell.setAlias(string alias, string program) | Sets an alias. | |
| shell.clearAlias(string alias) | Clears an alias. | |
| table programs | shell.programs([boolean hidden]) | Returns a table of programs. |
| boolean success | shell.run(string command [, string args1, string args2, ...]) | Runs a program. |
| string path | shell.getRunningProgram() | Returns the absolute path to the currently-executing program. |
| number newTabID | shell.openTab(string command [, string args1, string args2, ...]) | Runs a program in another multishell tab. Requires version 1.6 or newer and an advanced system. |
| shell.switchTab(number tabID) | Switches the multishell tab to tab with the given ID. Requires version 1.6 or newer and an advanced system. |
Note that shell.run and shell.openTab concatenate any arguments they are given (with single space separator characters) before parsing the command, and as of ComputerCraft version 1.45, now also support a single string containing all parameters.