NET RecvVar
Jump to navigation
Jump to search
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.
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. |
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. |
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() • NET_Accept() • NET_Incoming_Accept() |
| 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() |