NXC  Version 1.2.1 r5
 All Data Structures Files Functions Variables Groups Pages
char ReceiveRemoteString ( byte  queue,
bool  clear,
string &  str 

Read a string value from a queue/mailbox.

Read a string 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.

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.
A char value indicating whether the function call succeeded or not.