Revision as of 23:36, 5 July 2014

The /sockread command reads bytes from the receive buffer into a specified variable.

Synopsis

/sockread [-fn] [numbytes] <%var|&binvar>

Switches

Parameters

Example

When a socket connection, mySocket, has info waiting to be read from the buffer, store the info into a %myVar variable and echo it to a custom @myBuffer window:

ON 1:SOCKREAD:mySocket:{
  var %myVar
 
  ; Check for any socket errors; if they exist exit out of the event
  if ($sockerr > 0) { return }
 
  ; Create our jump loop for reading the socket buffer
  :nextread
 
  ; Read the buffer into the %myVar variable
  sockread %myVar
 
  ; Make sure that there is no socket break; if so exist out of the event
  if ($sockbr == 0) { return }
 
  ; If the buffer was empty, set the variable to printable empty space
  if (%myVar == $null) { %myVar = $chr(160) }
 
  ; Make sure our @myBuffer window is open; if not, create it
  if (!$window(@myBuffer)) { window @myBuffer }
 
  ; Echo the contents of the buffer variable into the @myBuffer window
  echo @myBuffer %myVar
 
  ; Go to the jump loop and read the rest of the buffer
  goto nextread
}

Compatibility

Added: mIRC v5.3

See Also

• List of commands
• List of identifiers
• $sock
• $sockname
• $sockerr
• $sockbr
• /sockaccept
• /sockclose
• /socklist
• /socklisten
• /sockmark
• /sockopen
• /sockpause
• /sockrename
• /sockudp
• /sockwrite