Semiconductor & Computer Engineering
(→Examples) |
|||
| Line 31: | Line 31: | ||
} | } | ||
</source> | </source> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Compatibility == | == Compatibility == | ||
Revision as of 19:37, 26 July 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.
mIRC in general only understand $crlf terminated line. With socket, mIRC will stop at $lf terminated line and any $cr before a $lf is removed.
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
You should be checking for $sockerr before reading data, here is a list of the possible value for $sockerr in the on SOCKREAD event:
- 0 - Data received correctly.
- 3 - Error on connected socket occurred, $sock().wsmsg will contain a more specific error message.
Examples
on *:sockread:name:{ if ($sockerr) { echo -s An error occured while trying to read data: $sock($sockname).wsmsg | return } else { sockread %a echo -s rcvd: %a } }
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.