This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
api:component [2015/01/14 23:40] 127.0.0.1 external edit |
api:component [2016/06/15 08:29] payonel [Component API] |
||
|---|---|---|---|
| Line 27: | Line 27: | ||
| - `component.setPrimary(componentType: string, address: string)` | - `component.setPrimary(componentType: string, address: string)` | ||
| Sets a new primary component for the specified component type. The address may be abbreviated, but must be valid if it is not `nil`. Triggers the `component_unavailable` and `component_available` signals if set to `nil` or a new value, respectively. | Sets a new primary component for the specified component type. The address may be abbreviated, but must be valid if it is not `nil`. Triggers the `component_unavailable` and `component_available` signals if set to `nil` or a new value, respectively. | ||
| - | - `component.list([filter: string]): function` | + | |
| - | Returns an iterator which returns pairs of `address, type` for each component connected to the computer. It optionally takes a filter - if specified this will only return those components for which the filter is a substring of the component type. For example: | + | |
| - | ```lua | + | |
| - | local component = require("component") | + | |
| - | -- prints `redstone` for each attached redstone card. | + | |
| - | for _, name in component.list("red") do print(name) end | + | |
| - | ``` | + | |
| Note that the component API has a metatable that allows the following syntax: | Note that the component API has a metatable that allows the following syntax: | ||
| - | ```lua | + | |
| + | ``` | ||
| local component = require("component") | local component = require("component") | ||
| local rs0 = component.getPrimary("redstone") | local rs0 = component.getPrimary("redstone") | ||
| Line 42: | Line 36: | ||
| print(rs0 == rs1) -- true | print(rs0 == rs1) -- true | ||
| ``` | ``` | ||
| + | |||
| + | |||
| Contents | Contents | ||
| ----------- | ----------- | ||
| {{page>api:contents&noheader&noeditbutton&nouser&nofooter}} | {{page>api:contents&noheader&noeditbutton&nouser&nofooter}} | ||