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

From FenixWiki

Revision as of 22:48, 12 September 2007 (edit) Sandman (Talk | contribs) m ← Previous diff		Current revision (11:58, 2 October 2007) (edit) (undo) Sandman (Talk | contribs) m (→Returns)
Line 32:		Line 32:
	| NET_ERROR_NONEWMESSAGE || - The incomingbuffer is empty.		| NET_ERROR_NONEWMESSAGE || - The incomingbuffer is empty.
	|-		|-
-	| NET_ERROR_UNFINISHEDMESSAGE || - The message in the incomingbuffer is incomplete.	+	| NET_ERROR_UNFINISHEDMESSAGE || - The data in the incomingbuffer is incomplete.
	|-		|-
-	| NET_ERROR_SIZEMISMATCH || - Sizes do not match (''length'' and the length of the received message(s)).	+	| NET_ERROR_SIZEMISMATCH || - Sizes do not match (''length'' and the length of the received data).
	|-		|-
-	| >=0 || - The size of the successfully received message. Without the separatorlength.	+	| >=0 || - The size of the successfully received data. Without the separatorlength.
	|}		|}

---

Current revision

Up to Network.DLL Functions

---

Contents 1 Definition 2 Parameters 3 Returns 4 Notes

[edit] Definition

INT NET_RecvVar ( <WORD connection> , <BYTE POINTER data> , <INT length> , [<BYTE includeseparator>] )

The receiving equivalent of NET_SendVar(): stores the data at the specified pointer, unlike NET_GetMessage(), which returns the message as a string, not allowing some variables.

[edit] Parameters

WORD connection	- The connection identifier.
BYTE pointer message	- The pointer the data/variable will be written to.
INT length	- The length/size of the data/variable.
[BYTE includeseparator]	- true/false: whether the connection's separator will be added to the received data at the end. Default is false.

[edit] Returns

INT : The size of the successfully received message. Without the separatorlength.

NET_ERROR_INVALIDCONN	- The connection is invalid.
NET_ERROR_CONNINACTIVE	- The connection is inactive.
NET_ERROR_NONEWMESSAGE	- The incomingbuffer is empty.
NET_ERROR_UNFINISHEDMESSAGE	- The data in the incomingbuffer is incomplete.
NET_ERROR_SIZEMISMATCH	- Sizes do not match (length and the length of the received data).
>=0	- The size of the successfully received data. Without the separatorlength.

[edit] Notes

This function is mainly to receive data sent with NET_SendVar().

Network.DLL Functions
Global	NET_Init() • NET_Quit() • NET_Version() • NET_IntVersion() • NET_About() • NET_GetError() • NET_Stat_Buffer() • NET_IntToIP() • NET_IPToInt()
Connections	NET_Connect() • NET_Listen() • NET_Disconnect() • NET_DisconnectAll()
Connection	NET_Resolve() • NET_Hostname() • NET_IPAddress() • NET_Port() • NET_Separator() • NET_GetSeparator() • NET_GetSeparatorLength()
Transfer	NET_Recv() • NET_RecvFile() • NET_RecvGraph() • NET_RecvVar() • NET_Send() • NET_SendFile() • NET_SendGraph() • NET_SendRN() • NET_SendVar()