term.native

From ComputerCraft Wiki
Jump to: navigation, search


Grid Redstone.png  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.

See also: term.current(), term.redirect(), term.restore()
Syntax term.native()
Returns table the original "term" table.
Part of ComputerCraft
API term

Examples

Grid paper.png  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.



Grid paper.png  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.