From WikiChip
Difference between revisions of "mirc/on events/on sockread"
< mirc‎ | on events

(See Also)
m (See Also)
Line 65: Line 65:
 
* {{mIRC|$sock}}
 
* {{mIRC|$sock}}
 
* {{mIRC|$sockbr}}
 
* {{mIRC|$sockbr}}
* {{mIRC|$sockerr}
+
* {{mIRC|$sockerr}}
  
 
[[Category:mIRC on events|sockread]]
 
[[Category:mIRC on events|sockread]]

Revision as of 01:39, 16 October 2014

The ON SOCKREAD triggers when there is info waiting to be read on the specified TCP socket connection. You can read this info using the /sockread command.

Note: If this event triggers but no /sockread is performed to attempt to read the buffer, it is assumed that no script exists that is handling this buffer, so it is cleared and the info it contained is lost.

Synopsis

ON <level>:SOCKREAD:<matchtext>:<commands>

Parameters

<matchtext>The name of the socket you want event to trigger on.

<commands>The commands to be performed when the event listener's criteria is met.

Connection State

It's important to check the value of $sockerr to determine if any connection errors occurred and handle that case. Here is a list of possible values returned by $sockerr in the on SOCKREAD event:

  • 0 - Data received correctly.
  • 3 - Error occurred on connected socket: $sock($sockname).wsmsg will contain a more specific error message.

Examples

You can find more information and examples in the /sockread command page.

Here is a basic outline:

on *:sockread:example:{
 
  ;if an error occurred ($sockerr is not 0)
  if ($sockerr) {
    echo -s An error occurred: $sock($sockname).wsmsg
  }
 
  ;no error occurred ($sockerr was 0)
  else {
 
    ;perform commands related to reading the data
 
    ;declare %r as a local variable for use in /sockread
    var %r
 
    ;read a line into %r from the buffer (this variable is subject to mIRC's Line Length Limit - see the /sockread page for more information)
    sockread %r
 
    ;do things with %r, such as checking its value or extracting parts to output later
 
  }
}

Compatibility

Added: mIRC v3.5
Added on: 07 Aug 1995
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also