User Tools

Site Tools


action:Switch_or_Case

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
action:Switch_or_Case [2021/10/15 01:21]
peternlewis [Parameters]
action:Switch_or_Case [2022/09/17 22:49] (current)
peternlewis [Switch/Case Action]
Line 4: Line 4:
  
 The _Switch_ Action is a good alternative to using multiple, nested, [[action:​If_Then_Else|If/​Then]] Actions. The _Switch_ Action is a good alternative to using multiple, nested, [[action:​If_Then_Else|If/​Then]] Actions.
 +
 +The actions in the first section that matches will be executed. If no section matches, then no actions will be executed and the execution will continue after the Switch/Case action. Under no circumstances will actions from more than one section be executed - that is, execution does not “fall through” to following sections as happens in some languages.
  
 ===== Parameters ===== ===== Parameters =====
Line 20: Line 22:
 When you insert the _Switch_ Action, it is configured to switch based on the _System Clipboard_, but can be easily changed to other parameters. ​ It initially looks like this: When you insert the _Switch_ Action, it is configured to switch based on the _System Clipboard_, but can be easily changed to other parameters. ​ It initially looks like this:
  
-{{:action:km-7.3-switch.png?​nolink|}}+{{:action:switch-case.png?​nolink|}}
  
 For each _Condition_ that you add, you can enter zero or more _Actions_ that will be executed when that _Condition_ is met.  After those _Action(s)_ are executed, or if no _Conditions_ are met, the _Switch_ Action is exited. For each _Condition_ that you add, you can enter zero or more _Actions_ that will be executed when that _Condition_ is met.  After those _Action(s)_ are executed, or if no _Conditions_ are met, the _Switch_ Action is exited.
Line 26: Line 28:
 ===== Conditions ===== ===== Conditions =====
  
-The _Conditions_ available depend on the _Parameter_ that is chosen+The _Conditions_ available depend on the _Parameter_ that is chosen ​(for example, you cannot use *has an image* with a calculation).
-{{:​action:​km-7.3-switch-conditions.png?​nolink|}}+
  
 The _Conditions_ are defined as follows: The _Conditions_ are defined as follows:
  
 ^Condition^Definition^ ^Condition^Definition^
 +|is empty|The text is contains no characters.|
 +|is not empty|The text is contains some characters.|
 |has text |Clipboard has at least one item containing text of some sort.| |has text |Clipboard has at least one item containing text of some sort.|
 |does not have text |Clipboard does not have any text items.| |does not have text |Clipboard does not have any text items.|
Line 38: Line 41:
 |is |is exactly (case insensitive) the specified string.| |is |is exactly (case insensitive) the specified string.|
 |is not |is not exactly (case insensitive) the specified string.| |is not |is not exactly (case insensitive) the specified string.|
 +|contains |contains (case insensitive) the specified string.|
 +|does not contain |does not contain (case insensitive) the specified string.|
 +|starts with |starts with the specified string.|
 +|ends with |ends with the specified string.|
 |is before |is alphabetically before the specified string. (v7.2+)| |is before |is alphabetically before the specified string. (v7.2+)|
 |is after |is alphabetically after the specified string. (v7.2+)| |is after |is alphabetically after the specified string. (v7.2+)|
-|contains |contains (case insensitive) the specified string.| 
-|does not contain |does not contain (case insensitive) the specified string.| 
 |matches |matches the specified regular expression.| |matches |matches the specified regular expression.|
 |does not match |does not match the specified regular expression.| |does not match |does not match the specified regular expression.|
 +|is <|is numerically less than.|
 +|is <=|is numerically less than or equal.|
 +|is =|is numerically equal.|
 +|is >=|is numerically greater than or equal.|
 +|is >|is numerically greater than.|
 +|is !=|is numerically not equal.|
 |conforms to |Clipboard has an item with the UTI class that conforms to the specified [Uniform Type Identifier](https://​en.wikipedia.org/​wiki/​Uniform_Type_Identifier).| |conforms to |Clipboard has an item with the UTI class that conforms to the specified [Uniform Type Identifier](https://​en.wikipedia.org/​wiki/​Uniform_Type_Identifier).|
 |does not conform to |Clipboard does not have an item with the UTI class that conforms to the specified Uniform Type Identifier.| |does not conform to |Clipboard does not have an item with the UTI class that conforms to the specified Uniform Type Identifier.|
Line 49: Line 60:
  
  
-The _Otherwise_ _Condition_ will execute if none of the above _Conditions_ are met.  The _Switch_ Action will then exit.  So, the _Otherwise_ _Condition_ should always be placed as the last _Condition_ in the _Switch_ Action. +The _Otherwise_ _Condition_ will execute if none of the previous ​_Conditions_ are met.  The _Switch_ Action will then exit.  So, the _Otherwise_ _Condition_ should always be placed as the last _Condition_ in the _Switch_ Action.
- +
----- +
  
 ===== See Also ===== ===== See Also =====
action/Switch_or_Case.1634275315.txt.gz · Last modified: 2021/10/15 01:21 by peternlewis