Difference between revisions of "Term.native"
From ComputerCraft Wiki
Bomb Bloke (Talk | contribs) m |
MKlegoman357 (Talk | contribs) m (Expanded) |
||
| Line 2: | Line 2: | ||
{{Function | {{Function | ||
|name=term.native | |name=term.native | ||
| − | |returns= | + | |returns={{type|table}} the original [[Term (API)|"term" table]]. |
|api=term | |api=term | ||
|addon=ComputerCraft | |addon=ComputerCraft | ||
| Line 11: | Line 11: | ||
Note that this change breaks backwards compatibility with scripts that assume term.native's prior identity.<br><br> | Note that this change breaks backwards compatibility with scripts that assume term.native's prior identity.<br><br> | ||
| − | See also: [[term.current | + | See also: [[term.current]](), [[term.redirect]](), [[term.restore]]() |
|examples= | |examples= | ||
{{Example | {{Example | ||
|desc=For pre-ComputerCraft 1.6, writes to the default display even if the terminal is currently redirected elsewhere. | |desc=For pre-ComputerCraft 1.6, writes to the default display even if the terminal is currently redirected elsewhere. | ||
| − | |code=term.native.write("I should appear on the computer's native display.") | + | |code='''term.native'''.write("I should appear on the computer's native display.") |
| + | |output=I should appear on the computer's native display. | ||
}} | }} | ||
{{Example | {{Example | ||
|desc=For ComputerCraft 1.6 or later, writes to the default display even if the terminal is currently redirected elsewhere. | |desc=For ComputerCraft 1.6 or later, writes to the default display even if the terminal is currently redirected elsewhere. | ||
| − | |code=term.native().write("I should appear on the computer's native display.") | + | |code='''term.native()'''.write("I should appear on the computer's native display.") |
| + | |output=I should appear on the computer's native display. | ||
}} | }} | ||
|notes= | |notes= | ||
Revision as of 16:47, 10 April 2014
 Function term.native | |
| Prior to ComputerCraft 1.6, "term.native" is a table pointer leading to the original "term" table (that is to say, the basic "term" API used to render to a given computer's own display). In cases where scripts have term.redirect()ed to an alternate display (eg a monitor), generally term.restore() can be used to switch back, but depending on the amount of redirects performed that may not lead to the original terminal with a single call - use of term.redirect(term.native) will generally hop back in one go. As of ComputerCraft 1.6, term.native is no longer a table but a function pointer, which must be called in order to receive the desired table back - for eg, term.redirect(term.native()) should be expected to return to the default display. Bear in mind that in most cases, you'll want to restore to whatever display you originally redirected from - term.current() can be used to help track that. Note that this change breaks backwards compatibility with scripts that assume term.native's prior identity. | |
| Syntax | term.native() |
| Returns | table the original "term" table. |
| Part of | ComputerCraft |
| API | term |
Examples
 Example | |
| For pre-ComputerCraft 1.6, writes to the default display even if the terminal is currently redirected elsewhere. | |
| Code |
term.native.write("I should appear on the computer's native display.")
|
| Output | I should appear on the computer's native display. |
| Example | |
| For ComputerCraft 1.6 or later, writes to the default display even if the terminal is currently redirected elsewhere. | |
| Code |
term.native().write("I should appear on the computer's native display.")
|
| Output | I should appear on the computer's native display. |
