Difference between revisions of "Rednet.receive"

From ComputerCraft Wiki
Jump to: navigation, search
m (Hurr. Fixed one, broke another.)
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.computerID()]], 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]]
+
|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 10:41, 30 November 2012


Grid Redstone.png  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

Grid paper.png  Example
Waits forever until someone sends a message to this computer and displays it.
Code
senderId, message, distance = rednet.receive()
term.write(message)
Output The received message.