Difference between revisions of "Rednet.receive"
From ComputerCraft Wiki
Jonjon1234 (Talk | contribs) |
m (Corrected links. Please do not link to pages that contain a parameter struct; they will be shortly deleted!) |
||
| Line 6: | Line 6: | ||
|api=rednet | |api=rednet | ||
|addon=ComputerCraft | |addon=ComputerCraft | ||
| − | |desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast( message )]] and [[rednet.send( receiverID, message )]]. If a Timeout occurs the return id and message are set to nil. If timeout is nil, waits forever.<br />To get the id from a computer see [[Os.getComputerID()]], or the [[id]] | + | |desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast|rednet.broadcast( message )]] and [[rednet.send|rednet.send( receiverID, message )]]. If a Timeout occurs the return id and message are set to nil. If timeout is nil, waits forever.<br />To get the id from a computer see [[Os.getComputerID|os.getComputerID()]], or the [[id]] program.<br/>You must be calling this function at the moment a message is sent, or you will miss it. If you need to watch for messages while doing something else at the same time, see [[Parallel.waitForAny|parallel.waitForAny()]] |
|examples= | |examples= | ||
{{Example | {{Example | ||
Revision as of 10:44, 30 November 2012
 Function rednet.receive | |
| Waits for timeoutSeconds or until another computer sends a message to this computer. (see rednet.broadcast( message ) and rednet.send( receiverID, message ). If a Timeout occurs the return id and message are set to nil. If timeout is nil, waits forever. To get the id from a computer see os.getComputerID(), or the id program. You must be calling this function at the moment a message is sent, or you will miss it. If you need to watch for messages while doing something else at the same time, see parallel.waitForAny() | |
| Syntax | rednet.receive(float timeoutSeconds) |
| Returns | senderId, message, distance-to-sender (or nil if using redpower bundled cable instead of a modem) |
| Part of | ComputerCraft |
| API | rednet |
Examples
 Example | |
| Waits forever until someone sends a message to this computer and displays it. | |
| Code |
senderId, message, distance = rednet.receive() |
| Output | The received message. |
