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

NET Send

From FenixWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 15:13, 14 April 2007 (edit)
Sandman (Talk | contribs)
m
← Previous diff
Current revision (22:48, 12 September 2007) (edit) (undo)
Sandman (Talk | contribs)
m
 
(6 intermediate revisions not shown.)
Line 1: Line 1:
[[Category:functions]] [[Category:functions]]
[[Category:networkdll]] [[Category:networkdll]]
 +[[Category:dll]]
 +
 +[[Functioncategory:Networkdll|'''Up to Network.DLL Functions''']]
 +----
 +
==Definition== ==Definition==
-'''INT''' NET_Send ( '''WORD''' connection , '''STRING''' message , ['''BYTE''' includeseperator] )+'''INT''' NET_Send ( <'''WORD''' connection> , <'''STRING''' message> , [<'''BYTE''' includeseparator>] )
-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 />+Sends a certain message to the other peer on a certain connection.
-Also called NET_Message().+
 +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.
-== Parameters ==+Also called [[NET_Message]]().
 +== 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;
Line 57: Line 60:
End End
</pre> </pre>
 +
 +{{Netfuncbox}}

Current revision

Up to Network.DLL Functions



Contents

[edit] Definition

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

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().

[edit] 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.

[edit] 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.

[edit] 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


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()
Personal tools