(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Introduction ==
+
<span style="color: #00828f; font-size: 24px; display: inline-block; margin-top: 15px; margin-bottom: 0px;"><strong>About variables</strong></span>
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
 
Variables can be used to store values (numbers, text strings and true/false conditions). These values can be set in the Set Variable Action. Variables can be used throughout the app as Triggers and Conditions, and can be used for controlling specific Macrodroid and system settings.
 
Variables can be used to store values (numbers, text strings and true/false conditions). These values can be set in the Set Variable Action. Variables can be used throughout the app as Triggers and Conditions, and can be used for controlling specific Macrodroid and system settings.
 
</pre>
 
</pre>
''''' An introduction video is available here '''''
+
'' An introduction video is available here ''
 
https://www.youtube.com/watch?v=0V_EcyhxrpA&t=1s
 
https://www.youtube.com/watch?v=0V_EcyhxrpA&t=1s
 
<br>
 
<br>
Line 10: Line 10:
  
 
=== Local ===
 
=== Local ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
Simplified:
+
'''Simplified:'''
 +
 
 
belongs to the macro it has been created into. It can only be used inside this macro. Its name must be unique inside the macro it belongs to.
 
belongs to the macro it has been created into. It can only be used inside this macro. Its name must be unique inside the macro it belongs to.
  
Advanced:
+
'''Advanced:'''
 +
 
 
Local variables are specific to a single macro. Use them only when the value is required within that macro. Local variables can be accessed through the edit macro screen.
 
Local variables are specific to a single macro. Use them only when the value is required within that macro. Local variables can be accessed through the edit macro screen.
</pre><br>
+
 
  
 
=== Global ===
 
=== Global ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
Simplified:
+
'''Simplified:'''
 +
 
 
Can be accessed and used from any macro. Its name must be unique among all the 'global' variables
 
Can be accessed and used from any macro. Its name must be unique among all the 'global' variables
  
Advanced:
+
'''Advanced:'''
Global variables are accessible throughout the application from any Macro. They should be used when storing a value between multiple macros. The list of global variables can be accessed via the Variables tile on the home screen, where you can add, delete, and modify their values.  
+
 
</pre><br>
+
Global variables are accessible throughout the application from any Macro. They should be used when storing a value between multiple macros. The list of global variables can be accessed via the Variables tile on the home screen, where you can add, delete, and modify their values.
  
 
==<p><b>Standard Variable Types</b></p>==
 
==<p><b>Standard Variable Types</b></p>==
  
 
=== Boolean ===
 
=== Boolean ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
allows 2 states: True or False
+
allows 2 states: True or False.
</pre><br>
 
  
 
=== Integer ===
 
=== Integer ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
 
to store positive or negative numbers without decimal part, in order to make any kind of mathematical calculations or comparison.
 
to store positive or negative numbers without decimal part, in order to make any kind of mathematical calculations or comparison.
</pre><br>
 
  
 
=== Decimal ===
 
=== Decimal ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
 
to store any positive or negative numeric value, with or without decimal digits, in order to make any kind of mathematical calculations or comparison. Sientific notation as 1.3E-2 may be used.
 
to store any positive or negative numeric value, with or without decimal digits, in order to make any kind of mathematical calculations or comparison. Sientific notation as 1.3E-2 may be used.
</pre><br>
 
  
 
=== String ===
 
=== String ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
 
contains any kind of character (alphanumeric ones or any special ones, such as line feed/carriage return/new line or emojis). HINT: an individual string variable can hold up to 500,000 characters, however it is advisable to avoid very long strings where possible. If you should use strings of great length it is recommended to clear them when finished with.
 
contains any kind of character (alphanumeric ones or any special ones, such as line feed/carriage return/new line or emojis). HINT: an individual string variable can hold up to 500,000 characters, however it is advisable to avoid very long strings where possible. If you should use strings of great length it is recommended to clear them when finished with.
</pre><br>
 
  
 
==<p><b>Data Structure Variable Types</b></p>==
 
==<p><b>Data Structure Variable Types</b></p>==
  
 
=== Array ===
 
=== Array ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
 
stores a series of values with associated index variables. For example if you wanted to store a count for each day of the month you could create an array called dayOfMonthCount and have a series of entries such as dayOfWeekCount[1] = 5, dayOfWeekCount[2] = 2 etc.
 
stores a series of values with associated index variables. For example if you wanted to store a count for each day of the month you could create an array called dayOfMonthCount and have a series of entries such as dayOfWeekCount[1] = 5, dayOfWeekCount[2] = 2 etc.
</pre><br>
 
  
 
=== Dictionary ===
 
=== Dictionary ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
 
stores a series of key value pairs. For example if you wanted to store a count for each day of the week you could create a dictionary called dayOfWeekCount and have a series of entries such as dayOfWeekCount [monday] = 1, dayOfWeekCount [tuesday] = 3 etc.
 
stores a series of key value pairs. For example if you wanted to store a count for each day of the week you could create a dictionary called dayOfWeekCount and have a series of entries such as dayOfWeekCount [monday] = 1, dayOfWeekCount [tuesday] = 3 etc.
</pre><br>
 

Latest revision as of 16:47, 23 April 2024

About variables

Variables can be used to store values (numbers, text strings and true/false conditions). These values can be set in the Set Variable Action. Variables can be used throughout the app as Triggers and Conditions, and can be used for controlling specific Macrodroid and system settings.

An introduction video is available here https://www.youtube.com/watch?v=0V_EcyhxrpA&t=1s

Global / Local Variables

Local

Simplified:

belongs to the macro it has been created into. It can only be used inside this macro. Its name must be unique inside the macro it belongs to.

Advanced:

Local variables are specific to a single macro. Use them only when the value is required within that macro. Local variables can be accessed through the edit macro screen.


Global

Simplified:

Can be accessed and used from any macro. Its name must be unique among all the 'global' variables

Advanced:

Global variables are accessible throughout the application from any Macro. They should be used when storing a value between multiple macros. The list of global variables can be accessed via the Variables tile on the home screen, where you can add, delete, and modify their values.

Standard Variable Types

Boolean

allows 2 states: True or False.

Integer

to store positive or negative numbers without decimal part, in order to make any kind of mathematical calculations or comparison.

Decimal

to store any positive or negative numeric value, with or without decimal digits, in order to make any kind of mathematical calculations or comparison. Sientific notation as 1.3E-2 may be used.

String

contains any kind of character (alphanumeric ones or any special ones, such as line feed/carriage return/new line or emojis). HINT: an individual string variable can hold up to 500,000 characters, however it is advisable to avoid very long strings where possible. If you should use strings of great length it is recommended to clear them when finished with.

Data Structure Variable Types

Array

stores a series of values with associated index variables. For example if you wanted to store a count for each day of the month you could create an array called dayOfMonthCount and have a series of entries such as dayOfWeekCount[1] = 5, dayOfWeekCount[2] = 2 etc.

Dictionary

stores a series of key value pairs. For example if you wanted to store a count for each day of the week you could create a dictionary called dayOfWeekCount and have a series of entries such as dayOfWeekCount [monday] = 1, dayOfWeekCount [tuesday] = 3 etc.