Difference between revisions of "Term.native"
From ComputerCraft Wiki
MKlegoman357 (Talk | contribs) m (Expanded) |
MKlegoman357 (Talk | contribs) m (Fixed) |
||
| Line 5: | Line 5: | ||
|api=term | |api=term | ||
|addon=ComputerCraft | |addon=ComputerCraft | ||
| − | |desc=Prior to ComputerCraft 1.6, | + | |desc=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|redirected]] 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.<br><br> |
| − | 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 | + | 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.<br><br> |
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> | ||
Latest revision as of 16:50, 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 redirected 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. |
