View source for Control flow: If clause

== Introduction ==


''' If statement '''

The '''If''' statement is available form the ‘Add Action’ menu part ‘Conditions/Loops’ and comes along with a terminating '''End IF'''.

This action allows to execute a set of subsequent actions according to specific condition(s). The possible conditions are the same as constraints and are tested in exactly the same way, with logical connectors 'AND' (default one) or 'OR' in case of multiple conditions.

In case the condition is met and a number of subsequent actions should be executed while different actions should be executed if the condition was not met an '''Else''' statement has to be implemented. 

''' Else statement '''

'''Else''' will only become available by selecting the '''If''' statement again and 
select ‘Add else clause’ from the ‘Set Variable’ menu.
In case further constrains should be invoked ‘Add else/If clause’ or ‘Add else/If confirmed clause’ can be used.

'''If''' statements my be nested that is within '''If''' and '''End If'''  there might be other pairs of '''If''' and '''End If'''.


</pre>
'''''[[Constraints|Constraints]] '''''
<br>

==<p><b>MacroDroid Variable/Compare Values</b></p>==

===  =  ===

<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
Means that the whole content of the string variable has to be equal to the whole set of typed characters.
</pre>
''''' Compatible with [https://macrodroidforum.com/wiki/index.php/Variables#Standard_Variable_Types Variables | String, Integer, Decimal, Boolean] (Boolean only in the compare values condition/constraints) '''''
<br>

===  != ===

<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
Means that the content of the string variable has to be unequal (i.e. different) to the set of typed characters.
</pre>
''''' Compatible with [https://macrodroidforum.com/wiki/index.php/Variables#Standard_Variable_Types Variables | String, Integer, Decimal, Boolean] (Boolean only in the compare values condition/constraints) '''''
<br>

=== Contains ===

<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
Means that the content of the string variable has to contain the whole set of typed character. For instance, enter the word information to match with a string variable containing the text: Here are the informations you asked for...
</pre>
''''' Compatible with [https://macrodroidforum.com/wiki/index.php/Variables#String Variables | String ''''']
<br>

=== Excludes ===

<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
Means that the content of the string variable has not to contain the typed text.
</pre>
''''' Compatible with [https://macrodroidforum.com/wiki/index.php/Variables#String Variables | String] '''''
<br>

==<p><b>The wildcards '*' and '?'</b></p>==

=== '''  *''' ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
'''*''' stands for any number of character (from 0 to any, same as '.*' in Regex).
</pre><br>

=== ? ===
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
'''?''' is for 1 and only 1 mandatory character (same as '.{1}' in Regex).
</pre><br>

* '''Tick the box '''Enter regular expression matching''' if the typed text follows Regex syntax, far more powerful than plain text with or without wildcards (for advanced users).'''