Editing mirc/commands/unset

{{mirc title|/unset Command}}
The '''/unset command''' removes any variables by their specified names. If a wildcard pattern was specified, all variables matching that pattern will be removed. The /unset command can be used to remove both local and global variables, however it can only remove one of them per name. Local variables take precedence over a global variable with the same name.

'''Note''': /unset has an evaluation issue with dynamic variables, you can read more [[Variables - mIRC#Special_behaviors_&_quirks|here]]

== Synopsis ==
 /unset [-slg] <%var> [%var2 [%var3...]]

== Switches ==
* '''-s''' - Display an output showing the variables that are unset*
* '''-g''' - Make sure the global variable is unset if you have both a global and local variable of the same name
* '''-l''' - Make sure the local variable is unset if you have both a global and local variable of the same name

== Parameters ==
None

== Example ==
The most basic usage is to unset a specific variable:

<syntaxhighlight lang="mIRC">/unset %foobar</syntaxhighlight>

Local variables take precedence over a global variable with the same name.

<syntaxhighlight lang="mIRC">alias global_local {
  set %foo 1
  var %foo 2
  echo -a %foo
  unset %foo
  echo -a %foo
  unset %foo
}</syntaxhighlight>

Which will produce the following result:

<pre>2
1</pre>

/unset can only remove a local or global variable per each name specified, however it’s possible to remove both by specifying the variable name twice, for example:

<syntaxhighlight lang="mIRC">alias global_local2 {
  set %foo 1
  var %foo 2
    
  ; unset both at once
  unset %foo %foo
  
  ; will print empty quotes
  echo -a $qt(%foo)
}</syntaxhighlight>

Which will print empty quotes:

<pre>""</pre>

No evaluation brackets are needed when unsetting dynamic variables:

<syntaxhighlight lang="mIRC">alias dynamic_vars {
  var -s %foo. $+ $calc(1+2) Test
  var -s %bar. $+ $calc(1+3) Test

  unset -s %foo. $+ $calc(1+2) %bar. $+ $calc(1+3)
}</syntaxhighlight>

Which will produce the following results:

<pre>* Set %foo.3 to Test
-
* Set %bar.4 to Test
-
* Unset %foo.3
-
* Unset %bar.4</pre>
if multiple cleaning 
<syntaxhighlight lang="mIRC">
/unset %semple,%foo,%cocorico,%mirc,%ms

 </syntaxhighlight>
<syntaxhighlight lang="mIRC">
alias unset {
  tokenize 44 $1-
  !.unset $*
}
 </syntaxhighlight>

== Compatibility ==
{{mIRC compatibility|4.0}}


== See also ==
* [[List of commands - mIRC|List of commands]]
* [[List of identifiers - mIRC|List of identifiers]]
* {{mIRC|$var}}
* {{mIRC|/dec}}
* {{mIRC|/inc}}
* {{mIRC|/set}}
* {{mIRC|/unsetall}}
* {{mIRC|/var}}
{{mIRC command list}}

[[Category:mIRC commands|unset command - mIRC]]