Close (Socket function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
Line 11: Line 11:
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%conn</th>
<tr><th>%number</th>
<td>If specified, this is a numeric variable to contain the returned value <code>1</code> from <var>Close</var>, indicating the connection is closed.
<td>If specified, this is a numeric variable to contain the returned value <code>1</code> from <var>Close</var>, indicating the connection is closed.
</td></tr>
</td></tr>

Revision as of 01:34, 15 November 2011

Close this socket connection (Socket class)


This method terminates the sending and receiving of data on, and removes from use, a Janus Sockets connection. The Close method, which may be invoked with a Call statement, has an effect similar to its equivalent $function, $Sock_Close.

Syntax

[%number =] socket:Close

Syntax terms

%number If specified, this is a numeric variable to contain the returned value 1 from Close, indicating the connection is closed.
socket A variable or an expression that is a reference to a Socket object.

Usage notes

  • In addition to closing the socket, the Close method destroys (discards) the object.
  • Close is not affected by any ONRESET setting. If the socket for which it is invoked is in the RESET state, Close continues to the next statement and does not set the last socket error information.

Example

The Close call signals that the program has completed all processing on the %sok socket:

%sok:Close