Revision as of 19:42, 5 July 2014

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 here

Synopsis

/unset [-s] <%var> [%var2 [%var3...]]

Switches

• -s - Display an output showing the variables that are unset

Parameters

None

Example

The most basic usage is to unset a specific variable:

/unset %foobar

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

alias global_local {
  set %foo 1
  var %foo 2
  echo -a %foo
  unset %foo
  echo -a %foo
  unset %foo
}

Which will produce the following result:

2
1

/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:

alias global_local2 {
  set %foo 1
  var %foo 2
    
  ; unset both at once
  unset %foo %foo
  
  ; will print empty quotes
  echo -a $qt(%foo)
}

Which will print empty quotes:

""

No evaluation brackets are needed when unsetting dynamic variables:

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)
}

Which will produce the following results:

* Set %foo.3 to Test
-
* Set %bar.4 to Test
-
* Unset %foo.3
-
* Unset %bar.4

Compatibility

Added: mIRC v4.0

Added On: 20/03/96

Note: Individual switches were not taken into consideration.

See also

• List of commands
• List of identifiers
• $var
• /dec
• /inc
• /set
• /unsetall
• /var