From WikiChip
Difference between revisions of "mirc/commands/inc"
m (PatrolBot moved page /inc command - mIRC to mirc/commands/inc: per new naming convention) |
(→Synopsis) |
||
(10 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{mirc title|/inc Command}} |
− | The '''/inc command''' increases the value of a variable by a given value. If | + | The '''/inc command''' increases the numeric value of a variable by a given value. If [value] is not specified, mIRC will increase the variable by one. The /inc command works with both positive and negative values alike. |
+ | |||
+ | '''Note''': /inc always keeps the unset time if there is one for the current variable, as though there was a -k switch from {{mIRC|/set}}, there's no switch to prevent this behavior and unset the time while setting the value. | ||
== Synopsis == | == Synopsis == | ||
− | /inc [- | + | /inc [-scrzeuN] <%var> [value] |
== Switches == | == Switches == | ||
− | |||
* '''-s''' - Prints out the value of the variable | * '''-s''' - Prints out the value of the variable | ||
− | * '''-z''' - | + | Global variables only: |
+ | * '''-c''' - Increases the variable by 1 every second | ||
+ | * '''-r''' - Increases the variable by 1 every second (same as -c) | ||
+ | * '''-z''' - Decreases the variable by 1 every second until it reaches zero at which point the variable will get unset. | ||
* '''-e''' - Unsets the variable when mIRC exits | * '''-e''' - Unsets the variable when mIRC exits | ||
− | * '''-uN''' - Increases the variable once and unsets the variable after N seconds | + | * '''-uN''' - Increases the variable once and unsets the variable after N seconds |
== Parameters == | == Parameters == | ||
* '''%var''' - The variable's name | * '''%var''' - The variable's name | ||
− | * '''[value]''' - Optional numeric value to increase the variable by | + | * '''[value]''' - Optional numeric value to increase the variable by. Default is 1 if [value] not used |
== Example == | == Example == | ||
Line 26: | Line 30: | ||
}</syntaxhighlight> | }</syntaxhighlight> | ||
+ | <source lang="mIRC"> | ||
+ | Note: if script or timer execution lasts longer than 1 second, -c and -z can skip increments or decrements: | ||
+ | //set %i 10 | inc -z %i | timertest 5 1 echo -a $!timer(test).reps $!asctime i= $eval(%i,0) $(|) var $eval(%j,0) 99999 $(|) while ( $eval(%j,0) ) $chr(123) var $eval(%k,0) $!rand(1,999) $(|) dec $eval(%j,0) $chr(125) | echo -a com: $timer(test).com | timer | ||
+ | |||
+ | //var %i 1 | inc %i 0 | echo -a this did not change i= %i | var %j $null | inc %i | echo -a this changed by 1 because [value] is null i= %i | ||
+ | this did not change i= 1 | ||
+ | this changed by 1 because [value] is null i= 2 | ||
+ | this incremented by 3 i= 5 | ||
+ | |||
+ | //var %i foo | inc %i | inc %i 5 | echo -a inc does not alter non-numeric values i= %i | ||
+ | </source> | ||
== Compatibility == | == Compatibility == | ||
{{mIRC compatibility|4.0}} | {{mIRC compatibility|4.0}} | ||
− | |||
== See also == | == See also == | ||
* [[List of commands - mIRC|List of commands]] | * [[List of commands - mIRC|List of commands]] | ||
Line 39: | Line 53: | ||
* {{mIRC|/var}} | * {{mIRC|/var}} | ||
{{mIRC command list}} | {{mIRC command list}} | ||
− | |||
[[Category:mIRC commands|inc command - mIRC]] | [[Category:mIRC commands|inc command - mIRC]] |
Latest revision as of 16:03, 17 February 2022
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
The /inc command increases the numeric value of a variable by a given value. If [value] is not specified, mIRC will increase the variable by one. The /inc command works with both positive and negative values alike.
Note: /inc always keeps the unset time if there is one for the current variable, as though there was a -k switch from /set, there's no switch to prevent this behavior and unset the time while setting the value.
Synopsis[edit]
/inc [-scrzeuN] <%var> [value]
Switches[edit]
- -s - Prints out the value of the variable
Global variables only:
- -c - Increases the variable by 1 every second
- -r - Increases the variable by 1 every second (same as -c)
- -z - Decreases the variable by 1 every second until it reaches zero at which point the variable will get unset.
- -e - Unsets the variable when mIRC exits
- -uN - Increases the variable once and unsets the variable after N seconds
Parameters[edit]
- %var - The variable's name
- [value] - Optional numeric value to increase the variable by. Default is 1 if [value] not used
Example[edit]
Alias Example { ;Create a local variable and set it to 5 var %x 5 ;Increase %x by 5 inc %x 5 ;Print out %x's content echo -a %x }
Note: if script or timer execution lasts longer than 1 second, -c and -z can skip increments or decrements: //set %i 10 | inc -z %i | timertest 5 1 echo -a $!timer(test).reps $!asctime i= $eval(%i,0) $(|) var $eval(%j,0) 99999 $(|) while ( $eval(%j,0) ) $chr(123) var $eval(%k,0) $!rand(1,999) $(|) dec $eval(%j,0) $chr(125) | echo -a com: $timer(test).com | timer //var %i 1 | inc %i 0 | echo -a this did not change i= %i | var %j $null | inc %i | echo -a this changed by 1 because [value] is null i= %i this did not change i= 1 this changed by 1 because [value] is null i= 2 this incremented by 3 i= 5 //var %i foo | inc %i | inc %i 5 | echo -a inc does not alter non-numeric values i= %i
Compatibility[edit]
Added: mIRC v4.0
Added on: 20 Mar 1996
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.
See also[edit]
mIRC commands list