Peripheral.find - Revision history

MKlegoman357: Undo revision 7172 by Wyvern67 (talk) | kinda unnecessary

2015-08-01T16:18:50Z

Undo revision 7172 by Wyvern67 (talk) | kinda unnecessary

Wyvern67 at 15:24, 1 August 2015

2015-08-01T15:24:20Z

Bomb Bloke: Rewording.

2014-05-04T10:37:46Z

Rewording.

Shazz at 02:48, 20 April 2014

2014-04-20T02:48:36Z

Shazz at 02:32, 20 April 2014

2014-04-20T02:32:32Z

MKlegoman357: Expanded

2014-04-17T19:52:37Z

Expanded

Oeed: Created page

2014-03-29T23:00:46Z

Created page

New page

{{lowercase}}
{{Function
|name=peripheral.find
|args= {{type|string}} peripheral type
|returns=A handle to a peripheral of the given type.
|api=peripheral
|addon=ComputerCraft
|desc=Returns a handle to a peripheral of the supplied type that can then be used to call methods, as if using peripheral.call(side, method)
|examples=
{{Example
|desc=Finds a monitor and writes 'Hello' on it.
|code=local monitor = peripheral.find('monitor') <br/>if monitor then <br/> monitor.write('Hello') <br/>end
|output=If there is a monitor connected 'Hello' will be written on it.
}}
}}

[[Category:Lua_Core_Functions]]

@@ Line 6: / Line 6: @@
 |api=peripheral
 |addon=ComputerCraft
-|desc=Introduced by ComputerCraft 1.6, returns a list of handles for connected peripherals that match the supplied type (essentially performing as a filtered version of [[peripheral.wrap|peripheral.wrap()]]).<br><br>
+|desc=Introduced by ComputerCraft 1.6, returns a list of handles for connected peripherals that match the supplied type (essentially performing as a filtered version of [[peripheral.wrap|peripheral.wrap()]]). If multiple peripherals are found, they are all returned as separate values, in the same order [[peripheral.getNames]]() returns. A custom function may additionally be passed as a parameter - if it's supplied, each matching peripheral's name and handle will be passed to it during the search, and they'll only be included in the final results if it returns <var>true</var>.
-−
-A custom function may additionally be passed as a parameter - if it's supplied, each matching peripheral's name and handle will be passed to it during the search, and they'll only be included in the final results if it returns "true".
 |examples=
 {{Example
@@ Line 20: / Line 18: @@
 }}
 {{Example
 |desc=Finds 2 '''advanced''' monitors and writes 'Hello' on the first and 'World' on the second.
-|code= local mon1, mon2 = '''peripheral.find("monitor", function(name, object) return object.isColour() end)'''
+|code= local mon1, mon2 = '''peripheral.find("monitor", function(name, object) return object.[[term.isColor|isColour]]() end)'''
   if mon1 then
@@ Line 34: / Line 32: @@
 }}
 }}
 [[Category:Lua_Core_Functions]]

@@ Line 20: / Line 20: @@
 }}
 {{Example
 |desc=Finds 2 '''advanced''' monitors and writes 'Hello' on the first and 'World' on the second.
 |code= local mon1, mon2 = '''peripheral.find("monitor", function(name, object) return object.isColour() end)'''
@@ Line 34: / Line 34: @@
 }}
 }}
 [[Category:Lua_Core_Functions]]

@@ Line 2: / Line 2: @@
 {{Function
 |name=peripheral.find
-|args={{type|string}} type
+|args={{type|string}} type [, {{type|function}} fnFilter( name, object )]
 |returns={{Type|table}} handle1, {{Type|table}} handle2, ... handles to peripherals of the given type
 |api=peripheral