Latest revision as of 01:49, 25 April 2023

$sockerr returns the sock error number if an error occurred.

$sockerr is not a local identifier only set inside event, it is set after any /sock* command as well, meaning that $sockerr can change in value inside the same on sockread event.

Synopsis[edit]

$sockerr

Parameters[edit]

None

Properties[edit]

None

Error codes[edit]

Remember that using a /sock* command will change the $sockerr value, so these error codes must be checked prior any /sock* command

on SOCKOPEN[edit]

• 0: success
• 3: failure establishing socket connection (W)
• 4: error resolving given hostname

on SOCKLISTEN[edit]

• 0: new socket successfully accepted
• 1: error occurred on listening socket (W)
• 2: error accepting new socket (W)
• 4: not enough memory for new socket

on SOCKREAD[edit]

• 0: data received
• 3: error on connected socket occurred (W)

on SOCKWRITE[edit]

• 0: all data successfully written
• 3: error trying to send data (W)

on SOCKCLOSE[edit]

• 0: EOF from other end received
• 3: an error occurred while receiving data, or a SSL error occurred (W)
• 5: a certain(?) SSL error occurred during sockopen

Note 1: (W) = For these errors, $sock().wserr contains a specific WinSock error number and $sock().wsmsg the Winsock error text

Note 2: These codes were taken from http://www.xise.nl/mirc/wiki/doku.php/doku.php?id=sockerr

Example[edit]

on *:sockread:name:{
  if ($sockerr) return
  …
}

Compatibility[edit]

Added: mIRC v5.3
Added on: 13 Dec 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also[edit]

• $sock
• $sockname
• $sockbr