$var » History » Revision 7
Revision 6 (Per Amundsen, 11/03/2020 06:15 AM) → Revision 7/8 (Per Amundsen, 11/03/2020 06:16 AM)
_Added in 1.9.0_
*$var(%var,[N])*
Returns the Nth matching variable name.
_Searches both local and global variables, [[Scripting_Wildcards|wildcards]] can be used._
_See also [[/var]], [[/set]], [[/unset]], [[/inc]], [[/dec]]._
*Parameters*
%var - Variable to match.
[N] - If N = 0, number of matched variables (default), otherwise the Nth match. (optional)
*Properties*
.value - The variable value.
.local - [[$true]] if the variable is a local variable, otherwise [[$false]].
.secs - Number of seconds until the variable is unset (if autounset is on).
.unset - Number of seconds until the variable is unset (if autounset is on).
*Examples*
<pre>
; Create a variable.
/set %Example Hello World
; Print number of variables matching '%Example*'.
//echo -ag $var(%Example*, 0)
; Print the name and value from the first match.
//echo -ag $var(%Example*, 1) = $var(%Example*, 1).value
; Delete the variable
/unset %Example
</pre>