This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
action:Search_Variable [2017/03/05 21:43] peternlewis [Forum] |
action:Search_Variable [2017/09/07 04:10] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | The Search Variable action allows you to search a variable for a [[:Regular Expressions|regular expression]] and capture what you find to one or more variables. This can be very useful for splitting apart the contents of a variable. | + | ~~REDIRECT>action:Search_using_Regular_Expression~~ |
- | {{:action:searchvariable.png|}} | ||
- | |||
- | You can search for: | ||
- | * Regular Expression, matching the case. | ||
- | * Regular Expression, ignoring the case. | ||
- | |||
- | Select the variable to search using the //Search variable// pop-up. | ||
- | |||
- | Select whether or not to match the case from the //using Regular Expression// pop-up. Then enter the text to search for in the text area. | ||
- | |||
- | Select where to save results with the //and save capture groups to Variables// pop-up. Depending on the nature of your search you may simply be presented with an //All// option, or with the opportunity to save multiple results to multiple variables. | ||
- | |||
- | If the search fails, by default (7.1+) the action will abort the macro and notify you of the failure. The destination variables will not be modified. You can turn off aborting the macro and/or notifying you in the gear menu (the destination variables will still not be modified in this case). | ||
- | |||
- | Examples: | ||
- | * Use a regular expression to search through a product price list and save only certain parts of it. | ||
- | |||
- | |||
- | Given a line like | ||
- | |||
- | //SKU1234 Widget 1 $12.95// | ||
- | |||
- | this could look like the following: | ||
- | |||
- | Search for: (SKU\d{4})\t(.+)\t(.+) | ||
- | |||
- | And capture: the first and third bracketed items to save only the SKU number and the price. | ||
- | |||
- | To work through a list you would need to include a loop or repeat of some kind. | ||
- | |||
- | {{:action:searchvariableexample.png|}} | ||
- | |||
- | Which results in: | ||
- | |||
- | {{:action:searchvariableresult.png|}} | ||
- | |||
- | ===== See Also ===== | ||
- | |||
- | ---- | ||
- | |||
- | === Actions === | ||
- | |||
- | * [[action:Search Clipboard|Search Clipboard]] | ||
- | * [[action:Search Variable|Search Variable]] | ||
- | * [[:Actions|See all Actions]] | ||
- | |||
- | ==== Topics ==== | ||
- | |||
- | * [[:Regular Expressions|Regular Expressions]] | ||
- | |||
- | ---- | ||
- | |||
- | ==== Forum ==== | ||
- | |||
- | - [[https://forum.keyboardmaestro.com/t/extracting-substring-of-a-variable/3007/2|Extracting substring of a Variable]] | ||
- | |||
- | - [[https://forum.keyboardmaestro.com/search?q=Search%20Variable|Keyboard Maestro Forum topics about Search Variable]] |