Term.current - Revision history

Bomb Bloke at 13:17, 31 March 2014

2014-03-31T13:17:14Z

Bomb Bloke: Elaboration on how term.current() serves to replace term.restore().

2014-03-31T13:14:08Z

Elaboration on how term.current() serves to replace term.restore().

Oeed: Created term.current page

2014-03-28T08:12:35Z

Created term.current page

New page

{{lowercase}}
{{Function
|name=term.current
|returns={{type|table}} terminal object
|api=term
|addon=ComputerCraft
|desc=Returns the current terminal object that is being used to write to.
|examples=
{{Example
|desc=Restores a program to the computer.
This will only work if the computer was running a program on a monitor
|code=term.redirect(peripheral.wrap('left')) -- switch to a monitor<br/>print('Hello!') -- write on the monitor<br/>print(term.current()) --returns the same as peripheral.wrap('left')
}}
|notes=
* [[term.current]]() requires ComputerCraft version 1.6 or newer.
}}

[[Category:API_Functions]]

@@ Line 10: / Line 10: @@
 |examples=
 {{Example
-|desc=Wraps a monitor at the top of the computer, then restores back to the previous display. Uses term.current() ''if available'', or [[term.restore|term.restore()]] if not.
+|desc=Wraps a monitor at the top of the computer, redirects to it, then restores back to the previous display. Uses term.current() ''if available'', or [[term.restore|term.restore()]] if not.
 |code= local mon = peripheral.wrap("top")

@@ Line 5: / Line 5: @@
 |api=term
 |addon=ComputerCraft
-|desc=Returns the current terminal object that is being used to write to.
+|desc=Added by ComputerCraft 1.6, this function returns the current terminal object that is being used to write to; if you intend to [[term.redirect|redirect]] elsewhere (eg to an attached [[Monitor]]), you may find need to record the identity of the previous object and redirect back to it when done.<br><br>
 |examples=
 {{Example
-|desc=Restores a program to the computer.
+|desc=Wraps a monitor at the top of the computer, then restores back to the previous display. Uses term.current() ''if available'', or [[term.restore|term.restore()]] if not.
-This will only work if the computer was running a program on a monitor
+|code= local mon = peripheral.wrap("top")
-|code=term.redirect(peripheral.wrap('left')) -- switch to a monitor<br/>print('Hello!') -- write on the monitor<br/>print(term.current()) --returns the same as peripheral.wrap('left')
 }}
 |notes=
-* [[term.current]]() requires ComputerCraft version 1.6 or newer.
+* term.current() requires ComputerCraft version 1.6 or newer.
 }}
 [[Category:API_Functions]]