Scripts - Iteration Operator

Script Loop=

Search and Replace v3.2+ has a special script operator, Script Loop=x, to permit a script to be repeated x number of times.

This operator is useful for situations where a search/replace string might not make all possible replacements on the first pass. This can happen, for example, when a * or *[] search operator in your overall regular expression search term spans text that includes a string component that you wish to have replacements done on. This can also happen if a replacement somehow impacts the next instance of a string that would be found by the search term.

Non-Regular Expression search/replaces would likely not be affected in this way.

The value can be larger than necessary. If no more search hits are found the program will stop the iterations.

Usage:

Script Loop=x

where x = the number of times to repeat the script. Search and Replace does not have an internal limit for the maximum value. Use a value of -1 to cause the script to repeat indefinitely (not recommended). Press the ESC key to abort a running script.

The Script Loop= setting must be added manually, via an external text editor.

This switch must be the last item in the [Options] section of the script.

Be sure to reload the script into Search and Replace if are using that same script in Search and Replace and made a manual edit with an external editor.

See Scripts - Format of Script files for more detail. Here is a small sample script:

[Script for Search and Replace]
[Options]
Script Loop=5
[Search /ix]
^\r\n\r\n\r\n
[Replace]
\r\n\r\n
[End of Search and Replace Script]