m (Bot: Fixing links) |
(→Example) |
||
(11 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{mirc title|/scon Command}} | ||
The '''/scon command''' can change the connection associated with the current script. When a command is not specified, mIRC changes the connection of the current script to the Nth connection. The rest of the code will continue to execute on that connection. When a command is specified, mIRC will execute the command on the specified connection or connections based on the switches provided. Any active connection changes are restored upon returning to the calling routine. A command can be executed on all or some of the connections depending on their types using the -a or -at<Type> switches. | The '''/scon command''' can change the connection associated with the current script. When a command is not specified, mIRC changes the connection of the current script to the Nth connection. The rest of the code will continue to execute on that connection. When a command is specified, mIRC will execute the command on the specified connection or connections based on the switches provided. Any active connection changes are restored upon returning to the calling routine. A command can be executed on all or some of the connections depending on their types using the -a or -at<Type> switches. | ||
Line 12: | Line 13: | ||
== Synopsis == | == Synopsis == | ||
− | /scon | + | /scon -rat<type>s [Nth] [command] |
− | |||
− | |||
− | |||
− | |||
− | |||
== Switches == | == Switches == | ||
− | * '''-r''' - Resets the connection | + | * '''-r''' - Resets the connection back to what it original was |
− | * '''-s''' - Prints the current connection | + | * '''-s''' - Prints the current connection number or the new connection number) |
* '''-a''' - Perform on all connections. | * '''-a''' - Perform on all connections. | ||
− | * '''- | + | * '''-t<type>''' - Perform on all the connections of a specific type, can only be used with -a. |
== Parameters == | == Parameters == | ||
* '''<Nth>''' - The Nth connection. | * '''<Nth>''' - The Nth connection. | ||
− | * '''<type>''' - The connection type, only used with | + | * '''<type>''' - The connection type, only used with the t switch. |
== Example == | == Example == | ||
Line 46: | Line 42: | ||
} | } | ||
; all active connections | ; all active connections | ||
− | scon -at1 amsg $1- | + | scon -at1 amsg $unsafe($1-) |
}</syntaxhighlight> | }</syntaxhighlight> | ||
Line 64: | Line 60: | ||
; print channels | ; print channels | ||
− | scon -r echo -s Network: $network Channels: %chans | + | scon -r echo -s $unsafe(Network: $network Channels: %chans) |
; next connection | ; next connection | ||
Line 72: | Line 68: | ||
== Compatibility == | == Compatibility == | ||
− | + | {{mIRC compatibility|6.0}} | |
− | |||
− | |||
− | |||
− | |||
− | |||
== See also == | == See also == | ||
Line 90: | Line 81: | ||
{{mIRC command list}} | {{mIRC command list}} | ||
− | [[Category: | + | [[Category:mIRC commands|scon command - mIRC]] |
Latest revision as of 08:32, 28 March 2020
The /scon command can change the connection associated with the current script. When a command is not specified, mIRC changes the connection of the current script to the Nth connection. The rest of the code will continue to execute on that connection. When a command is specified, mIRC will execute the command on the specified connection or connections based on the switches provided. Any active connection changes are restored upon returning to the calling routine. A command can be executed on all or some of the connections depending on their types using the -a or -at<Type> switches.
Connection Type[edit]
- 1 = Connected
- 2 = Disconnected or Connecting
- 3 = 1+2 = Connected, Disconnected, or Connecting (Same as -a)
- 4 = Connecting
- 5 = 1+4 = Connected or Connecting
- 6 = 2+4 = 2 = Disconnected or Connecting
- 7 = 3+4 = Disconnected or Connected or Connecting
- 8 = Disconnected
Synopsis[edit]
/scon -rat<type>s [Nth] [command]
Switches[edit]
- -r - Resets the connection back to what it original was
- -s - Prints the current connection number or the new connection number)
- -a - Perform on all connections.
- -t<type> - Perform on all the connections of a specific type, can only be used with -a.
Parameters[edit]
- <Nth> - The Nth connection.
- <type> - The connection type, only used with the t switch.
Example[edit]
A simple example of using /scon to send a command to all connected connections.
/* ** Global amsg - performs an amsg on all the ** the actives connections you are on. ** ** /gamsg <message> */ alias gamsg { if (!$1) { echo -gtcse info * /gamsg: insufficient parameters halt } ; all active connections scon -at1 amsg $unsafe($1-) }
Print all the channels you are on from every connection you have:
alias listChans { var %x = 1 while ($scon(%x)) { ; switch connection scon %x ; iterate over the channels var %c = 1, %chans while ($chan(%c)) { var %chans = $addtok(%chans, $chr(32) $v1, 44) inc %c } ; print channels scon -r echo -s $unsafe(Network: $network Channels: %chans) ; next connection inc %x } }
Compatibility[edit]
Added: mIRC v6.0
Added on: 03 Feb 2002
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.