|
Magic File Renamer Help
|
Index > Reference
> Filters > Replacing
Filters > Replacer Filter
This filter perform search & replace opeartion on names.
-
Replace Text box
-
Here you should input the string you want to search for.
-
Should contain a regular expression if
Use regular expressions
is checked.
-
With Text box
-
Here you should input the string you want use as a replacement for occurrences
of the searched string.
-
You can leave the With
text box empty, to strip (remove) occurrences of the searched string.
-
The With text box may contain a
format string with formatting parameters.
-
Match Case
-
When checked, only occurrences that matches the exact letters casing of the
search string will be replaced.
-
Replace only first occurrence
-
When checked, only the first occurrence of the search string in each name will
be replaced.
-
Replace only whole words
-
When checked, only occurrences of the search string which forms a whole word,
will be replaced.
-
For an occurrence to form a whole word, the couple of characters before and
after it should not be letters or digits.
-
This option cannot be combined with the Use regular expressions
option.
-
Use regular expressions
-
This option allows you to search for a pattern instead of a literal string and
perform an advanced search and replace.
-
When checked, search string will be treated as a Regular
Expression.
-
You will be able to use the menu buttons in the right side of the
Search and With
text boxes to input common regular expression tokens.
-
The With
text box may contain "$n" tokens, if the search regular expression performs
capturing.
-
If seacrch regular expression is not valid, the Replacer Filter will be
disabled.
-
See Regular Expressions Reference
for more details.
-
Can be applied on any text field.
Examples:
Replace "dog"
with "cat"
, replace only whole words:
The dogs ran away from the big dog >>> The dogs ran away from the
big cat
Replace "\((.+)\)"
with "$1"
, use regular
expressions:
aaa (bbb) ccc >>> aaa bbb ccc