NET Recv - Revision history

Sandman at 22:47, 12 September 2007

2007-09-12T22:47:33Z

←Older revision		Revision as of 22:47, 12 September 2007
Line 71:		Line 71:
	End		End
	</pre>		</pre>
		+
		+	{{Netfuncbox}}

Sandman at 01:36, 1 September 2007

2007-09-01T01:36:05Z

←Older revision		Revision as of 01:36, 1 September 2007
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
-	[[Category:~~networkdllfunctions~~]]	+	[[Category:networkdll]]
		+	[[Category:dll]]

-	[[~~networkdllfunctions~~\|'''Up to Network.DLL Functions''']]	+	[[Functioncategory:Networkdll\|'''Up to Network.DLL Functions''']]
	----		----

Sandman at 21:46, 24 July 2007

2007-07-24T21:46:28Z

←Older revision		Revision as of 21:46, 24 July 2007
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
	[[Category:networkdllfunctions]]		[[Category:networkdllfunctions]]
		+
		+	[[networkdllfunctions\|'''Up to Network.DLL Functions''']]
		+	----
		+

	==Definition==		==Definition==

-	'''INT''' NET_Recv ( '''WORD''' connection , ['''BYTE''' includeseperator] )	+	'''INT''' NET_Recv ( <'''WORD''' connection> , [<'''BYTE''' includeseperator>] )

-	Gets the waiting message on a connection~~. The function will keep returning messages until it returns "", which indicates no more new messages. So it is best to put this function in a frameless loop, like so:~~	+	Gets the waiting message on a certain connection.
-	~~<pre>~~	+
-	~~msg = NET_Recv(conn_c);~~	+
-	~~Repeat~~	+
-	~~say("Incoming(" + conn_c + "): " + msg);~~	+
-	~~msg = NET_Recv(conn_c);~~	+
-	~~Until(len(msg)<=0)~~	+
-	~~</pre>~~	+
-	~~This way it will still return "" if "" was indeed sent. If you don't need this or you have some other reason, you can change the loop to suit your needs.<br />~~	+
-	~~Also called NET_GetMessage()~~.	+

		+	The function will keep returning messages until it returns "", which indicates no more new messages.

	== Parameters ==		== Parameters ==
-
	{\|		{\|
-	\| '''WORD''' connection \|\| The connection identifier.	+	\| '''WORD''' connection \|\| - The connection identifier.
	\|-		\|-
-	\| ['''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] \|\| - When true, the separator will be added to the message at the end. When false, it won't. Default is true.
	\|}		\|}

		+	Also called NET_GetMessage().

	== Returns ==		== Returns ==
-
	'''INT''' : [[NET_ERRORCODES\|Network.DLL Errorcode]]		'''INT''' : [[NET_ERRORCODES\|Network.DLL Errorcode]]
	{\|		{\|
-	\| "" \|\| There was an error or no message.	+	\| "" \|\| - There was an error or no message.
	\|-		\|-
-	\| !"" \|\| The message (string). It appears this can also be a byte, word or integer. Just make sure the other peer sent it like it was received.	+	\| !"" \|\| - The message (string). It appears this can also be a byte, word or integer. Just make sure the other peer sent it like it was received.
	\|}		\|}

		+	== Notes ==
		+	It is best to put this function in a frameless loop, like so:
		+	<pre>
		+	msg = NET_Recv(conn_c);
		+	Repeat
		+	say("Incoming(" + conn_c + "): " + msg);
		+	msg = NET_Recv(conn_c);
		+	Until(len(msg)<=0)
		+	</pre>
		+	This way it will still return "" if "" was indeed sent. If you don't need this or you have some other reason, you can change the loop to suit your needs, like:
		+	<pre>
		+	while(len(msg = NET_Recv(conn_c))>0)
		+	say("Incoming(" + conn_c + "): " + msg);
		+	End
		+	</pre>

	== Example ==		== Example ==
-
	<pre>		<pre>
	Program example;		Program example;

Sandman: Changed some NET_GetMessage()'s to NET_Recv()'s

2007-04-15T23:36:43Z

Changed some NET_GetMessage()'s to NET_Recv()'s

←Older revision		Revision as of 23:36, 15 April 2007
Line 8:		Line 8:
	Gets the waiting message on a connection. The function will keep returning messages until it returns "", which indicates no more new messages. So it is best to put this function in a frameless loop, like so:		Gets the waiting message on a connection. The function will keep returning messages until it returns "", which indicates no more new messages. So it is best to put this function in a frameless loop, like so:
	<pre>		<pre>
-	msg = ~~NET_GetMessage~~(conn_c);	+	msg = NET_Recv(conn_c);
	Repeat		Repeat
	say("Incoming(" + conn_c + "): " + msg);		say("Incoming(" + conn_c + "): " + msg);
-	msg = ~~NET_GetMessage~~(conn_c);	+	msg = NET_Recv(conn_c);
	Until(len(msg)<=0)		Until(len(msg)<=0)
	</pre>		</pre>
Line 52:		Line 52:
	Loop		Loop
	If(NET.Incoming[netid])		If(NET.Incoming[netid])
-	While( (message = ~~NET_GetMessage~~(netid)) !="" )	+	While( (message = NET_Recv(netid)) !="" )
	say("Incoming(" + netid + "): " + message);		say("Incoming(" + netid + "): " + message);
	End		End

Sandman at 23:00, 15 April 2007

2007-04-15T23:00:48Z

←Older revision		Revision as of 23:00, 15 April 2007
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
-	[[Category:~~networkdll~~]]	+	[[Category:networkdllfunctions]]

	==Definition==		==Definition==

Sandman at 15:15, 14 April 2007

2007-04-14T15:15:43Z

←Older revision		Revision as of 15:15, 14 April 2007
Line 25:		Line 25:
	\| ['''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] \|\| When true, the separator will be added to the message at the end. When false, it won't. Default is true.
	\|}		\|}
		+

	== Returns ==		== Returns ==
Line 34:		Line 35:
	\| !"" \|\| The message (string). It appears this can also be a byte, word or integer. Just make sure the other peer sent it like it was received.		\| !"" \|\| The message (string). It appears this can also be a byte, word or integer. Just make sure the other peer sent it like it was received.
	\|}		\|}
		+

	== Example ==		== Example ==

Sandman: /* Parameters */

2007-04-14T15:10:39Z

Parameters

←Older revision		Revision as of 15:10, 14 April 2007
Line 23:		Line 23:
	\| '''WORD''' connection \|\| The connection identifier.		\| '''WORD''' connection \|\| The connection identifier.
	\|-		\|-
-	\| [~~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] \|\| When true, the separator will be added to the message at the end. When false, it won't. Default is true.
	\|}		\|}
-

	== Returns ==		== Returns ==

Sandman at 15:03, 14 April 2007

2007-04-14T15:03:40Z

New page

[[Category:functions]]
[[Category:networkdll]]

==Definition==

'''INT''' NET_Recv ( '''WORD''' connection , ['''BYTE''' includeseperator] )

Gets the waiting message on a connection. The function will keep returning messages until it returns "", which indicates no more new messages. So it is best to put this function in a frameless loop, like so:
<pre>
msg = NET_GetMessage(conn_c);
Repeat
say("Incoming(" + conn_c + "): " + msg);
msg = NET_GetMessage(conn_c);
Until(len(msg)<=0)
</pre>
This way it will still return "" if "" was indeed sent. If you don't need this or you have some other reason, you can change the loop to suit your needs.<br />
Also called NET_GetMessage().

== Parameters ==

{|
| '''WORD''' connection || The connection identifier.
|-
| [byte includeseparator] || When true, the separator will be added to the message at the end. When false, it won't. Default is true.
|}

== Returns ==

'''INT''' : [[NET_ERRORCODES|Network.DLL Errorcode]]
{|
| "" || There was an error or no message.
|-
| !"" || The message (string). It appears this can also be a byte, word or integer. Just make sure the other peer sent it like it was received.
|}

== Example ==

<pre>
Program example;
include "Network.fh";
Private
int netid;
string message;
Begin

NET_Init(0,10,1);
netid = NET_Connect("www.google.com",80,true);

Loop
If(NET.Incoming[netid])
While( (message = NET_GetMessage(netid)) !="" )
say("Incoming(" + netid + "): " + message);
End
End
frame;
End

End
</pre>