Differences

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

--- action:For_Each [2016/01/20 14:10]
AlainLifchitz
+++ action:For_Each [2021/10/12 23:24] (current)
peternlewis
@@ Line 1: / Line 1: @@
-The For Each action loops over a set of [collections](:Collections) of items, setting a variable to each value and executing the contained actions.
+====== For Each Action ======
-Whenever you need to deal with a list of things (lines, files, volumes, numbers, etc), the For Each action is a good place to start. For example, you can use this action to split text into lines or substrings.
-{{:action:foreach.png|}}
+The *For Each* action loops over a set of [collections](:Collections) of items, setting a variable to each value and executing the contained actions.
-Enter a variable or select from the pop-up at the end of the //For each// text area.
+It is one of several Actions that _loop_ through a set of other Actions until some criteria is met.
-Add a collection by clicking the green + button beside //New Collection// to select from a list of available collections. You can learn more about the available collections on the [[:Collections]] page.
+Whenever you need to deal with a list of things (lines, files, volumes, numbers, etc), the For Each action is a good place to start.
-When you choose a specific collection, further options may become available.
+===== How To Use =====
-Drag one or more actions into the //No Action// area.
+  - Add the //For Each// Action, from the //Control Flow// Category, to your macro
+    - {{:action:km-editor-for-each-action.png?nolink|}}
+    - {{:action:km-for-each-action-2.png?nolink|}}
+  - Enter a variable or select from the pop-up at the end of the //For each// text area.
+    * This variable will contain each item in the Collection list as the For Each Action loops
+    * This can be a new or existing variable, as your needs dictate
+    * You can then use or process this item as needed
+  - Add a collection by clicking the green + button beside //New Collection// to select from a list of available collections. You can learn more about the available collections on the [[:Collections]] page.
+  - When you choose a specific collection, further options may become available.
+  - Add one or more actions into the //No Action// (which means no actions have been added yet) area.
+    * These actions will operate on each item in the Collection that is stored in the Variable from Step #2
-See also these forum topics:
+You can break out of the loop, retry this iteration, or skip to the next iteration with the [[actions:Redirect_Control_Flow|actions:Redirect Control Flow]] actions.
-[[https://forum.keyboardmaestro.com/t/text-filtering/2763/14|Text filtering]]
+There is an option in the action (gear) ⚙ menu to display the progress of the For Each action (v10.0+).
+===== Examples =====
+**Example #1:  Split text into lines or substrings**
+{{:action:km-for-each-lines-example.png?nolink|}}
+For a complete macro using this Action, see [[https://forum.keyboardmaestro.com/t/macro-file-process-lines-in-text-file/2936|MACRO: [FILE] Process Lines in Text File]]
+**Example #2:  Get Capture Group for Multiple Matches**
+See [[:Regular Expressions#Examples|Regular Expressions (RegEx) Examples]]
+===== See also =====
+=== Actions ===
+* [[action:For_Each|For Each]] action
+* [[action:Repeat|Repeat]] action
+* [[action:Until|Until]] action
+* [[action:While|While]] action
+* [[action:Assert|Assert]] action
+* [[:Actions|See all actions]]
+=== Triggers ===
+* [[trigger:Typed String|trigger:Typed String]]
+* [[:Triggers|See all triggers]]
+==== Forum ====
+- [[https://forum.keyboardmaestro.com/t/text-filtering/2763/14|Text filtering]]
+- [[https://forum.keyboardmaestro.com/t/microsoft-word-make-numbers-in-selectd-text-superscript-without-affecting-the-words/2895/4|Microsoft Word: Make numbers in selected text superscript without affecting the words]]
+- [[https://forum.keyboardmaestro.com/t/macro-file-process-lines-in-text-file/2936|MACRO: [FILE] Process Lines in Text File]]
+- [[https://forum.keyboardmaestro.com/t/for-each-item-difficulty-understanding-action/3162/2|For Each Item]]

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools