Editing mirc/commands/sockudp

The '''/sockudp command''' allows you to send data to a specific address at a specific port destination (See [[UDP Sockets - mIRC|UDP sockets]]).

'''Note''': if /sockudp fails, it sets [[$sock identifier - mIRC|$sock().wserr]] to the error value, and trigger on sockwrite with [[$sockerr identifier - mIRC|$sockerr]] set etc.

== Synopsis ==
/sockudp -bntkduz [bindip] <name> [port] <ipaddress> <port> [numbytes] [text|%var|&binvar]

== Switches ==
* '''-b''' - Indicates that you are specifying the numbytes value which is the number of bytes you want send, the full line is sent otherwise
* '''-n''' - Appens a [[$crlf identifier - mIRC|$crlf]] to the line being sent if it's not a &binvar or if does not already end with a $crlf
* '''-t''' - Forces mIRC to send anything beginning with a & as plain text
* '''-k''' - Keeps the socket opened
* '''-d''' - Means you have specified the ip address as the bind address
* '''-u''' - Enables dual stack socket to support both ipv4 and ipv6 for the listening socket, if that is available, you must bind to an ipv6 ip address
* '''-z''' - Wait for the data to be sent if any and then close the socket

== Parameters ==
* '''[bindip]''' - If -d has been specified, the ip address you want to use as the bind address.
* '''<name>''' - The sockname name.
* '''[port]''' - If specified, the local port to use, otherwise mIRC choose one randomly.
* '''<ipaddress>''' - The ip address you want to send to information to, use you localhost 127.0.0.1 with -k to create a listening socket.
* '''<port>''' - The port you want to send to information to, that's your listening port if you create a server.
* '''[numbytes]''' - If -b has been specified, indicates the number of bytes you want to send.
* '''[text|%var|&binvar]''' - If specified, the message you want to send, can be a binary variable. You don't want to specify that parameter if you create a server.

== Example ==


== Compatibility ==
Added: mIRC v5.5

Added On: 08/01/99


<small>Note: Individual switches were not taken into consideration.</small>

== See also ==
* [[List of commands - mIRC|List of commands]]
* [[List of identifiers - mIRC|List of identifiers]]
* {{mIRC|on udpread}}
* {{mIRC|on sockwrite}}
* {{mIRC|$sockerr}}
{{mIRC command list}}

[[Category:MIRC commands]]
@@ Line 1: / Line 1: @@
-{{mirc title|/sockudp Command}}
+The '''/sockudp command''' allows you to send data to a specific address at a specific port destination (See [[UDP Sockets - mIRC|UDP sockets]]).
-The '''/sockudp command''' allows you to send data to a specific address at a specific port destination (See {{mIRC|UDP sockets}}).
-'''Note''': if /sockudp fails, it sets {{mIRC|$sock|$sock().wserr}} to the error value, and trigger on sockwrite with {{mIRC|$sockerr}} set etc.
+'''Note''': if /sockudp fails, it sets [[$sock identifier - mIRC|$sock().wserr]] to the error value, and trigger on sockwrite with [[$sockerr identifier - mIRC|$sockerr]] set etc.
 == Synopsis ==
@@ Line 9: / Line 8: @@
 == Switches ==
 * '''-b''' - Indicates that you are specifying the numbytes value which is the number of bytes you want send, the full line is sent otherwise
-* '''-n''' - Appens a {{mIRC|$crlf}} to the line being sent if it's not a &binvar or if does not already end with a $crlf
+* '''-n''' - Appens a [[$crlf identifier - mIRC|$crlf]] to the line being sent if it's not a &binvar or if does not already end with a $crlf
 * '''-t''' - Forces mIRC to send anything beginning with a & as plain text
 * '''-k''' - Keeps the socket opened
@@ Line 26: / Line 25: @@
 == Example ==
-<source lang="mIRC">
-alias gettime {
-  ; Set a NULL byte binary variable.
-  bset &null 1 0
-  ; Open a UDP connection to Time-a.nist.gov = 129.6.15.28
-  sockudp -k gettime 129.6.15.28 37 &null
-}
-ON *:UDPREAD:gettime: {
+== Compatibility ==
-  ; Read the reply.
+Added: mIRC v5.5
-  sockread -f &time
-  var %time $bvar(&time,1,$bvar(&time,0))
+Added On: 08/01/99
-  ; Convert to binary, remove spaces.
-  var %bin $regsubex(%time, /(\d+)\s?/g, $base(\1, 10, 2, 8))
-  ; Get the current unix time in decimal system.
+<small>Note: Individual switches were not taken into consideration.</small>
-  var %time = $base(%bin, 2, 10)
-  ; Print the time.
-  echo -ag Currnt Time/Date: $asctime($calc(%time - 2208988800), yyyy-mm-dd hh:nn:ss TT)
-  ; Close the socket
-  sockclose $sockname
-}
-</source>
-== Compatibility ==
-{{mIRC compatibility|5.5}}
 == See also ==
@@ Line 66: / Line 43: @@
 {{mIRC command list}}
-[[Category:mIRC commands|sockudp command - mIRC]]
+[[Category:MIRC commands]]