server_socket_read(sock, length=-1, timeout=-1)
Features
This function reads data from the client.
Parameters
| Parameter Name | Data Type | Default Value | Description |
|---|---|---|---|
sock | socket.socket | - | Socket instance returned from server_socket_open() socket instance |
length | int | -1 | Number of bytes of the received data
|
timeout | int float | -1 | Waiting time for receipt
|
Return
Value (res, rx_data) | Description | |
res | 0 | Number of bytes of the received data |
-1 | The client is not connected. | |
-2 | socket.error occurred during data reception | |
-3 | Timeout during data reception | |
rx_data | Received data (byte type) | |
Example
PY
sock = server_socket_open(20002)
res, rx_data = server_socket_read(sock) # Indefinite wait until the data is received
# Reads all received data since the length is omitted.
# Waits indefinitely until the data is received since timeout is omitted.
# (res = size of received data, rx_data=received data) is returned when the data is received.
res, rx_data = server_socket_read(sock, timeout=3) # Waits for up to 3 seconds until the data is received.
# (res = size of received data, rx_data=received data) is returned if the data is received within 3 seconds.
# (res = -3, rx_data=None) is returned if the data is not received within 3 seconds.
res, rx_data = server_socket_read(sock, length=64) # Reads 64 bytes of the received data.
res, rx_data = server_socket_read(sock, length=64, timeout=3)
# Reads 64 bytes of the received data within the 3-second timeout.
rx_msg = rx_data.decode() # rx_data is a byte type and can be converted to a string type
# using decode().
# For example, if rx_data = b"abcd",
# rx_msg= "abcd".
server_socket_close(sock)