Sock.Getinband Method

Top  Previous  Next

 

Function:

For the selected socket (selection is made through sock.num) returns the string that contains the data extracted from the CMD buffer.

Syntax:

sock.getinband as string

Returns:

String containing data from the CMD buffer

See Also:


 


Part

Description



Details

The CMD buffer is the buffer that accumulates inband commands. Extracted data is permanently deleted from the CMD buffer. Length of extracted data is limited by one of the two factors (whichever is smaller): amount of data in the CMD buffer itself, and the capacity of the "receiving" buffer variable. Several inband commands may be waiting in the CMD buffer. Each command will always be complete, i.e. there will be no situation when you will extract a portion of the command because the end of this command hasn't arrived yet. Inband commands stored in the CMD buffer will have escape character (see sock.escchar property) and the character after the escape character already cut off, but the end character (see sock.endchar property) will still be present. Therefore, your application can separate inband command from each other by finding the end characters.