$Sock_Close

From m204wiki
Revision as of 21:18, 19 January 2012 by JAL (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Close Janus Sockets connection(s)

Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is currently no direct OO equivalent for this $function.

$Sock_Close terminates the sending and receiving of data on, and removes from use, one or all Janus Sockets connection(s).

Syntax

[%num =]$Sock_Close[([sockNum])]

Syntax terms

%num The number of of connections closed.
sockNum The number of a socket that is to be closed, or the value -1, which indicates that all the user's sockets should be closed. The default value of this optional argument is -1.

Usage notes

  • If socket is -1, indicating that all sockets are affected by the $Sock_Close call, then the returned number %num will be the number of sockets in use. Otherwise 1 is returned.
  • $Sock_Close is not affected by any ONRESET setting.

Examples

  1. In the following example, the $Sock_Close call signals that the program has completed all processing on the socket identified by the value in %sock:

    %count = $Sock_Close(%sock)

  2. The following call closes all socket connections the user has:

    %count = $Sock_Close(-1)