BEE Script:   socketread socketObj [maxlength=integer];

BEE Tag:      <beesocketread socketObj [maxlength=integer]>

The "socketread" command reads a message from the socket.  The content and length of the read message are stored in socketObj%read:content and socketObj%read:length.

In order to read all bytes in the message, you may need to implement the "socketread" command as a while loop:

socketread mySock;

var msgRead = "";

while ({mySock%read:length}) {

        var msgRead = "{msgRead}{mySock%read:content}";

        socketread mySock;

}

// Now msgRead contains the message read from the socket.

Note: "socketread" is binary safe.

Parameters

socket (the socketObj) is the name of the socket to read.

maxlength is the maximum number of bytes that the command will read.  If there are more to read beyond this limit, the excessive data will be left unread until the next "socketread" command.