> For the complete documentation index, see [llms.txt](https://docs.nedyx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nedyx.com/version-1.83-de/nedyx/clearlines-funktionen/text-funktionen/substitute.md).

# SUBSTITUTE

#### Syntax <a href="#syntax.53" id="syntax.53"></a>

**SUBSTITUTE**(*text*; *oldText*; *newText; option*)

* *text* - der Text, in dem nach oldText gesucht werden soll - ***Wertetyp**: Text*
* *oldText* - den Text, der im Parameter text zu finden ist - ***Wertetyp**: Text*
* *newText* - der Text, durch den oldText ersetzt werden soll- ***Wertetyp**: Text*
* *option* - definiert, ob die Ersetzung mit einem regulären Ausdruck erfolgen soll - ***Wertetyp**: Konstante (optional, Standardwert: empty)*

  Mögliche Werte sind:

  * *empty* (*option* ist nicht angegeben) - die Ersetzung basiert auf dem Klartext von *oldText* und *newText*
  * *<mark style="color:red;">regex</mark>* - die Ersetzung verwendet einen regulären Ausdrucks für den Parameter *oldText*

#### Bemerkungen <a href="#remarks.40" id="remarks.40"></a>

* Der Parameter *text* kann auch ein Bereich sein mit mehreren Texten. Die SUBSTITUTE Funktion in dann auf alle diese Texte angewendet.
* Für die Parameter *oldText* und *newText* können auch Spaltenbereiche angegeben werden. Die Textersetzung erfolgt dann nacheinander (von oben nach unten) für alle Textpaare dieser beiden Parameter.
* Bei der Suche wird die Groß- und Kleinschreibung beachtet, so dass der gefundene Text im Parameter *text* die gleiche Groß- und Kleinschreibung haben muss wie der Parameter *oldText*.

#### Beispiele <a href="#examples.17" id="examples.17"></a>

<figure><img src="/files/v2MMsxZ41mwMbRyA5zhd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fN8UWHe6J9DY1MxmMo7O" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/41a16HmFT4s3W2KfjoTV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PXIQ91it4jEHX2JkCFTa" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fagFe6Yu5DsT3dtRhpie" alt=""><figcaption></figcaption></figure>