2020-11-08 09:34:05 +00:00
caption: search-replace
created: 20201107111139011
2021-08-29 16:45:59 +00:00
modified: 20210829174535854
2020-11-08 09:34:05 +00:00
op-input: a [[selection of titles|Title Selection]]
op-output: the input titles with the search string replaced with the replacement string
op-parameter: the <<.op search-replace>> operator requires 2 parameters, see below for details
op-purpose: returns each item in the list, replacing within each title the string specified by the first parameter with the second parameter
op-suffix: the <<.op search-replace>> operator uses a rich suffix, see below for details
tags: [[Filter Operators]] [[String Operators]]
title: search-replace Operator
type: text/vnd.tiddlywiki
<<.from-version "5.1.23">>
The <<.op search-replace>> operator uses an extended syntax that allows for multiple suffixes and parameters to be passed:
```
[search-replace:<flag list>:<regexp-mode>[<search-term>],[<replacement>]]
```
2021-08-29 16:45:59 +00:00
* ''flag-list'': ''g'' for global mode to replace all matches, ''i'' for case-insensitive mode, <<.from-version "5.2.0">> ''m'' for multiline mode, "gim" for all. (optional)
2020-11-08 09:34:05 +00:00
* ''regexp-mode'': ''regexp'' to treat the first parameter as a regular expression (optional).
* ''search-term'': string or regular expression that should be replaced
* ''replacement'': string that should replace the search-term
<<.tip "Either [[parameter|Filter Parameter]] can be a string, a text reference or a variable">>
<<.operator-examples "search-replace">>