socket.recv [method]

socket.recv( int maxlength[, int flags ])

attempt to receive at most maxlength bytes of pending data

• socket may block if blocking is enabled and there's no data at the moment
  • maximum blocking time is determined by socket's recv_timeout property
• return values:
  • false if there was an error
  • true if socket was closed
  • byte buffer containing 1 - maxlength bytes if read was successful