User Tools

Site Tools


columns_ui:config:global_variables

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
columns_ui:config:global_variables [2013/01/05 21:28]
79.181.68.35 deleted spam
columns_ui:config:global_variables [2018/07/25 18:18] (current)
musicmusic
Line 3: Line 3:
 Global variables were created as a way of speeding up playlist formatting, by separating the parts of formatting that is common to all your columns, and only processing it once per track instead of once per column. It works by defining variables which you can access in your column display strings. Global variables were created as a way of speeding up playlist formatting, by separating the parts of formatting that is common to all your columns, and only processing it once per track instead of once per column. It works by defining variables which you can access in your column display strings.
  
-Note: Information on the legacy format for global variables can be viewed [[columns_ui:​0.1.2:​config:​global_variables|here]]. 
 ===== Global variables string ===== ===== Global variables string =====
 This string, in the [[columns_ui:​config:​playlist_view:​globals]] configuration page, is where you define your variables. This string, in the [[columns_ui:​config:​playlist_view:​globals]] configuration page, is where you define your variables.
Line 9: Line 8:
 ==== Setting variables ==== ==== Setting variables ====
  
-You can set variables in your global variables string using the ''​set_global''​ function. ​ The syntax is as follows:+You can set variables in your global variables string using the ''​$set_global()''​ function. ​ The syntax is as follows:
  
-^ Standard-syntax titleformatting ^ Script-syntax titleformatting ^ +''​$set_global(//​variable name//,//​variable value//​)''​
-| $''​set_global''​(//variable name//,//​variable value//​) ​''​set_global''​(//​variable name//,//​variable value//) |+
  
 Note: You can only define globals in the global string - i.e. you cannot access defined globals. Note: You can only define globals in the global string - i.e. you cannot access defined globals.
  
-The truth value of a call to ''​set_global''​ with the correct number of parameters is true.+The truth value of a call to ''​$set_global()''​ with the correct number of parameters is true.
  
 ===== Accessing global variables ===== ===== Accessing global variables =====
  
-You can access global variables in your display and style strings using the ''​get_global''​ function. The syntax is as follows:+You can access global variables in your display and style strings using the ''​$get_global()''​ function. The syntax is as follows:
  
-^ Standard-syntax titleformatting ^ Script-syntax titleformatting ^ +''​$get_global(//​variable name//​)''​
-| $''​get_global''​(//variable name//​) ​''​get_global''​(//​variable name//) |+
  
 where where
-  * //variable name// is the name of the variable as defined in the ''​set_global''​ function call+  * //variable name// is the name of the variable as defined in the ''​$set_global()''​ function call
   * the return value is the //variable value//   * the return value is the //variable value//
  
-The truth value of a call to ''​get_global''​ with the correct number of parameters is true iff the variable has been set in a previous call to ''​set_global'',​ irrespective of what the variable was set to. +The truth value of a call to ''​$get_global()''​ with the correct number of parameters is true iff the variable has been set in a previous call to ''​$set_global()'',​ irrespective of what the variable was set to.
- +
-===== Notes on using the script-syntax ===== +
- +
-Things to remember: +
-  * Strings are enclosed in quotation marks. For example: <​code>​get_global("​my_var"​);</​code>​ +
-  * To print a string you must use the print() function. For example: <​code>​print(get_global("​my_var"​));</​code>​+
columns_ui/config/global_variables.txt · Last modified: 2018/07/25 18:18 by musicmusic