This wiki is out of date, use the continuation of this wiki instead

From FenixWiki

Revision as of 23:00, 15 April 2007 (edit) Sandman (Talk | contribs) m ← Previous diff		Revision as of 21:51, 24 July 2007 (edit) (undo) Sandman (Talk | contribs) m Next diff →
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
	[[Category:networkdllfunctions]]		[[Category:networkdllfunctions]]
		+
		+	[[networkdllfunctions|'''Up to Network.DLL Functions''']]
		+	----
		+
	==Definition==		==Definition==
-	'''INT''' NET_Send ( '''WORD''' connection , '''STRING''' message , ['''BYTE''' includeseperator] )	+	'''INT''' NET_Send ( <'''WORD''' connection> , <'''STRING''' message> , [<'''BYTE''' includeseperator>] )
		+
		+	Sends a certain message to the other peer on a certain connection.
		+
		+	It appears the message can also be a byte, word or integer. Just make sure the other peer receives it like it was sent. For those variables [[NET_SendVar]]() is recommended though.
-	Sends a message. It appears this can also be a byte, word or integer. Just make sure the other peer receives it like it was sent. For those variables [[NET_SendVar]]() is recommended though.<br />
	Also called NET_Message().		Also called NET_Message().
-
	== Parameters ==		== Parameters ==
-
	{|		{|
-	| '''WORD''' connection || The connection identifier.	+	| '''WORD''' connection || - The connection identifier of the connection on which the other peer is to receive the message.
	|-		|-
-	| '''STRING''' message || The message.	+	| '''STRING''' message || - The message.
	|-		|-
-	| ['''BYTE''' includeseparator] || When true, the separator will be added to the message at the end. When false, it won't. Default is true.	+	| ['''BYTE''' includeseparator] || - [[true]]/[[false]]: whether the connection's separator will be added to the message at the end. Default is true.
	|}		|}
-
	== Returns ==		== Returns ==
-		+	'''INT''' : The size of the successfully sent message. With the separatorlength, if the separator was added.
-	'''INT''' : [[NET_ERRORCODES|Network.DLL Errorcode]]	+
	{|		{|
-	| NET_ERROR_INVALIDCONN || The connection is invalid.	+	| NET_ERROR_INVALIDCONN || - The connection is invalid.
	|-		|-
-	| NET_ERROR_CONNINACTIVE || The connection is inactive.	+	| NET_ERROR_CONNINACTIVE || - The connection is inactive.
	|-		|-
-	| NET_ERROR_MESSAGETOOLONG || The message is too long.	+	| NET_ERROR_MESSAGETOOLONG || - The message is too long.
	|-		|-
-	| NET_ERROR_MESSAGETOOSHORT || The message is too short.	+	| NET_ERROR_MESSAGETOOSHORT || - The message is too short.
	|-		|-
-	| NET_ERROR_SENDING || Could not send.	+	| NET_ERROR_SENDING || - Could not send.
	|-		|-
-	| >=0 || The size of the succesfully sent message. With the separatorlength, if the separator was added.	+	| >=0 || - The size of the successfully sent message. With the separatorlength, if the separator was added.
	|}		|}
-
	== Example ==		== Example ==
-
	<pre>		<pre>
	Program example;		Program example;

---

Revision as of 21:51, 24 July 2007

Up to Network.DLL Functions

---

Contents 1 Definition 2 Parameters 3 Returns 4 Example

Definition

INT NET_Send ( <WORD connection> , <STRING message> , [<BYTE includeseperator>] )

Sends a certain message to the other peer on a certain connection.

It appears the message can also be a byte, word or integer. Just make sure the other peer receives it like it was sent. For those variables NET_SendVar() is recommended though.

Also called NET_Message().

Parameters

WORD connection	- The connection identifier of the connection on which the other peer is to receive the message.
STRING message	- The message.
[BYTE includeseparator]	- true/false: whether the connection's separator will be added to the message at the end. Default is true.

Returns

INT : The size of the successfully sent message. With the separatorlength, if the separator was added.

NET_ERROR_INVALIDCONN	- The connection is invalid.
NET_ERROR_CONNINACTIVE	- The connection is inactive.
NET_ERROR_MESSAGETOOLONG	- The message is too long.
NET_ERROR_MESSAGETOOSHORT	- The message is too short.
NET_ERROR_SENDING	- Could not send.
>=0	- The size of the successfully sent message. With the separatorlength, if the separator was added.

Example

Program example;
    include "Network.fh";
Private
    int netid;
Begin

    NET_Init(0,10,1);
    netid = NET_Connect("www.google.com",80,true);
    NET_Send(netid,"HELLO!"+chr(13)+chr(10)); // This is not a valid HTTP protocol message
   
    Loop
        frame;
    End

End