Project

General

Profile

$var » History » Revision 2

Revision 1 (Per Amundsen, 08/11/2015 01:46 PM) → Revision 2/8 (Per Amundsen, 08/11/2015 01:46 PM)

_Added in 1.9.0_ 

 *$var(%var,[N])* 

 Returns the Nth matching variable name. 

 _Searched both local and global variables and can use wildcards for the %var name._ 

 *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). 

 *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>