NXC  Version 1.2.1 r5
 All Data Structures Files Functions Variables Groups Pages
char ReceiveRemoteMessageEx ( byte  queue,
bool  clear,
string &  str,
long &  val,
bool &  bval 
)
inline

Read a value from a queue/mailbox.

Read a value from a mailbox and optionally remove it. If the local mailbox is empty and this NXT is the master then it attempts to poll one of its slave NXTs for a message from the response mailbox that corresponds to the specified local mailbox number. Output the value in string, number, and boolean form.

Parameters
queueThe mailbox number. See Mailbox constants.
clearA flag indicating whether to remove the message from the mailbox after it has been read.
strThe string value that is read from the mailbox.
valThe numeric value that is read from the mailbox.
bvalThe boolean value that is read from the mailbox.
Returns
A char value indicating whether the function call succeeded or not.
Examples:
ex_ReceiveRemoteMessageEx.nxc.