Difference between revisions of "Term.native"
From ComputerCraft Wiki
Bomb Bloke (Talk | contribs) (As of ComputerCraft 1.6, term.native now points to a function, not a table.) |
Bomb Bloke (Talk | contribs) m |
||
| Line 7: | Line 7: | ||
|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|term.redirect()ed]] to an alternate display (eg a [[monitor]]), generally [[term.restore|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> | |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|term.redirect()ed]] to an alternate display (eg a [[monitor]]), generally [[term.restore|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, '''term.redirect(term.native())''' should be expected to return | + | 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|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> | ||
Revision as of 06:08, 4 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 | 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.")
|
| 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.")
|
