JAL2 at 19:04, 11 June 2012

2012-06-11T19:04:10Z

← Older revision		Revision as of 19:04, 11 June 2012
Line 1:		Line 1:
	{{Template:Socket:Send subtitle}}		{{Template:Socket:Send subtitle}}

	This method sends a string over a <var class="product">Janus Sockets</var> connection.		This [[Notation conventions for methods#Callable functions\|callable]] method sends a string over a <var class="product">Janus Sockets</var> connection.
	The <var>Send</var> function~~, which may be invoked with a <var>Call</var> statement,~~		The <var>Send</var> function has an effect similar to <var>[[$Sock_Send]]</var>.
	has an effect similar to <var>[[$Sock_Send]]</var>.

	==Syntax==		==Syntax==
	{{Template:Socket:Send syntax}}		{{Template:Socket:Send syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th><td>~~number~~</td></tr>		<tr><th>%number</th>
			<td>This is a numeric variable to contain the returned indicator of success of the function.
			The return value is either of these:
			<table>
			<tr><th>0</th>
			<td>The function completed successfully.</td></tr>
			<tr><th>-1 </th>
			<td>The socket is not open, and <code>ONRESET CONTINUE</code> is in effect for the socket.</td></tr>
			</table></td></tr>

	<tr><th>socket</th>		<tr><th>socket</th>
	<td>A variable or an expression that is a reference to a <var>Socket</var> object.</td></tr>		<td>A variable or an expression that is a reference to a <var>Socket</var> object.</td></tr>

	<tr><th>string</th>		<tr><th>string</th>
	<td>string</td></tr>		<td>The string to send.</td></tr>

	<tr><th><var>Options</var></th>		<tr><th><var>Options</var></th>
	<td>string</td></tr>		<td>This optional argument is an option string that may contain any
			of the following:
			<table class="syntaxTable">
			<tr><th><var>BINARY</var></th>
			<td>Regardless of whether the <var>BINARY</var> or <var>CHAR</var> parameter is in effect for the socket's port, data <b>is not translated</b> when sent. The argument can be the result of a previous translation using the <var>[[TranOut (Socket function)\|TranOut]]</var> method.</td></tr>

			<tr><th><var>CHAR</var></th>
			<td>Regardless of whether the <var>[[BINARY]]</var> or <var>[[CHAR]]</var> parameter is in effect for the socket's port, data <b>is translated</b> when sent. The translation is specified by the output table defined by the socket's <var>[[XTAB]]</var> parameter.</td></tr>

			<tr><th><var>FIN</var></th>
			<td>After <var class="term">string</var> is sent, no more data will be sent on the socket. This transmits the <code>FIN</code> indication to the remote partner.
			<p>Note that when <code>FIN</code> is sent, print capturing is automatically turned <var>OFF</var> for the socket.</p></td></tr>

			<tr><th><var>PUSH</var></th>
			<td>Ensures that the data being sent on the socket is immediately sent to the receiver. Normally, data to be sent is buffered and may not be sent immediately.
			<p> Using <var>PUSH</var> is <b>not</b> necessary if: </p>
			<ul>
			<li>You are specifying <code>FIN</code>, since a push operation is implied by <var>FIN</var>.
			<li>You are alternating sends and receives on a socket, since receive-processing methods (<var>[[Receive (Socket function)\|Receive]]Receive</var> and <var>[[ReceiveAndParse (Socket function)\|ReceiveAndParse]]</var>) always do a push before receiving.
			</ul></td></tr></table>
			</td></tr>
	</table>		</table>

			==Usage notes==
			<ul>
			<li>If you need to send line-end delimited information, use the <var>[[SendWithLineEnd (Socket function)\|SendWithLineEnd]]</var> method.
			</ul>

	~~==Usage notes==~~
	~~==Examples==~~
	==See also==		==See also==
	{{Template:Socket:Send footer}}		{{Template:Socket:Send footer}}

JAL2 at 18:42, 11 June 2012

2012-06-11T18:42:57Z

← Older revision		Revision as of 18:42, 11 June 2012
Line 1:		Line 1:
	{{Template:Socket:Send subtitle}}		{{Template:Socket:Send subtitle}}

	This ~~page is~~ [[~~under construction~~]].		This method sends a string over a <var class="product">Janus Sockets</var> connection.
			The <var>Send</var> function, which may be invoked with a <var>Call</var> statement,
			has an effect similar to <var>[[$Sock_Send]]</var>.

	==Syntax==		==Syntax==
	{{Template:Socket:Send syntax}}		{{Template:Socket:Send syntax}}

JAL2: /* Syntax terms */

2011-11-15T02:03:29Z

Syntax terms

← Older revision		Revision as of 02:03, 15 November 2011
Line 8:		Line 8:
	<tr><th>%number</th><td>number</td></tr>		<tr><th>%number</th><td>number</td></tr>
	<tr><th>socket</th>		<tr><th>socket</th>
	<td>Socket object</td></tr>		<td>A variable or an expression that is a reference to a <var>Socket</var> object.</td></tr>
	<tr><th>string</th>		<tr><th>string</th>
	<td>string</td></tr>		<td>string</td></tr>
Line 14:		Line 14:
	<td>string</td></tr>		<td>string</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	==Examples==		==Examples==
	==See also==		==See also==
	{{Template:Socket:Send footer}}		{{Template:Socket:Send footer}}

JALWiccan: Automatically generated page update

2011-11-14T23:14:31Z

Automatically generated page update

New page

{{Template:Socket:Send subtitle}}

This page is [[under construction]].
==Syntax==
{{Template:Socket:Send syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%number</th><td>number</td></tr>
<tr><th>socket</th>
<td>Socket object</td></tr>
<tr><th>string</th>
<td>string</td></tr>
<tr><th><var>Options</var></th>
<td>string</td></tr>
</table>
==Usage notes==
==Examples==
==See also==
{{Template:Socket:Send footer}}

Send (Socket function) - Revision history

JAL2 at 19:04, 11 June 2012

JAL2 at 18:42, 11 June 2012

JAL2: /* Syntax terms */

JALWiccan: Automatically generated page update