.rxlen R/O Property
|
Function: |
For the selected socket (selection is made through sock.num), returns the total number of bytes currently waiting in the RX buffer to be extracted and processed by your application. |
|
Type: |
Word | dword |
|
Value Range: |
Platform-dependent, default = 0 |
|
See Also: |
--- |
Details
The on_sock_data_arrival event is generated once the RX buffer is not empty (i.e., there is data to process). There may be only one on_ser_data_arrival event for each socket waiting to be processed in the event queue. Another on_sock_data_arrival event for the same socket may be generated only after the previous one is handled.
If, during the on_sock_data_arrival event handler execution, not all data is extracted from the RX buffer, another on_sock_data_arrival event is generated immediately after the on_sock_data_arrival event handler is exited.
Older devices had smaller RAM sizes, so the value returned by this property was of the word type. On newer devices with larger RAM capacities, this property has the dword type. Inspect the property's declaration on the platform you are using to make sure you know its type.