Difference between revisions of "Os.loadAPI"
From ComputerCraft Wiki
m (Small inversion removed) |
MKlegoman357 (Talk | contribs) (Restored it as it was correct) |
||
| Line 8: | Line 8: | ||
|desc=Loads a user created API from a file located at <var>path</var>. | |desc=Loads a user created API from a file located at <var>path</var>. | ||
<br/> | <br/> | ||
| − | This function runs the file, collects all global (non-localized) variables from it and puts them into a [[table_(type)|table]] into the global (<var>_G</var>) environment. The name of the | + | This function runs the file, collects all global (non-localized) variables from it and puts them into a [[table_(type)|table]] into the global (<var>_G</var>) environment. The name of the table in the _G table becomes the name of the file. |
|examples={{Example | |examples={{Example | ||
|desc=Loads an API saved at "''test/myAPI''" and runs the global function "''hello''" from it. | |desc=Loads an API saved at "''test/myAPI''" and runs the global function "''hello''" from it. | ||
Revision as of 19:18, 12 May 2015
 Function os.loadAPI | |
| Loads a user created API from a file located at path.
| |
| Syntax | os.loadAPI(string path) |
| Returns | boolean did the API load successfully? |
| Part of | ComputerCraft |
| API | OS |
Examples
 Example | |
| Loads an API saved at "test/myAPI" and runs the global function "hello" from it. | |
| Code |
--test/myAPI: local text = "Hello World!" -- this won't be seen from outside of the API because it is localized function hello () -- this will be seen from outside the API because it is not localized print(text) end --The program that will use "myAPI"
os.loadAPI("test/myAPI") -- load the API
myAPI.hello() -- runs the function "hello" from the API
|
| Output | Hello World! |
Additional Notes
- path must be an absolute path.
- All variables which will be needed to be accessed through <apiname>.<variable/function> must be global.
- By default APIs cannot access shell API and multishell API.
