Shell (API)
From ComputerCraft Wiki
Revision as of 19:25, 4 April 2014 by MKlegoman357 (Talk | contribs) (renamed shell.programs optional argument)
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 showHidden]) | 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.
