Difference between revisions of "Rednet.receive"
From ComputerCraft Wiki
m (Moved to CAT:APIFunctions) |
(Fixed references to pages.) |
||
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. | + | |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]] command.<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]] |
|examples= | |examples= | ||
{{Example | {{Example |
Revision as of 22:01, 28 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 command. 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. |